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Figure 1-1 . 4110 Series Computer Display Terminals „ 
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Section 1 
INTRODUCTION 



The 4 110 Series Command Reference manual is intended for the 
programmer who is writing a package of host computer subrou- 
tines to communicate with any TEKTRONIX 4110 Series Computer 
Display Terminal . 

The appropriate terminal host programmer's manual describes 
the terminal programming consid er at ions and details which a 
programmer must be aware of when preparing the host computer 
subroutine package to communicate with a 4110 Series termi- 
nal and its options. This manual is primarily a reference 
manual and will be used by the programmer more than any 
other manual once the programmer becomes f am il iar with the 
terminal . 



MANUAL ORGANIZATION 

Th is manual is d iv ided into four major sections . Section 1 
(this section) provides an introduc t ion and overv iew , and 
lists the conventions used in the manual . Section 2 de- 
scribes the syn tax and general format of 4110 Ser ies 
commands . Section 3 contains a f unct ional listing of all 
commands . 

Section 4 (the major portion of the manual ) is an alphabeti- 
cal listing of all 4110 commands . This section also includes 
( alphabetically) a description of such things as control 
characters , keys , message formats , parameters , etc . Note 
that in the al phabet ic listings , numbers ( eg . 4010) follow 
the other 1 i stings . 

The remainder of the manual consists of various append ices 
and a "Keyword in Context" index : 

• Append ix A ASCII Code Charts contains a 
s'tandard ASCII Code chart and additional charts 

wh ich define the ASCII characters used for various 
types of parameters • 

• Append ix B <Int> Parameters contains a cross- 
reference of numbers to their correspond ing < In t> 
parameters . 
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$ Appendix C Error Codes contains a complete 
listing of error codes. The error codes are listed 
alphabetically by command op codes. 

$ Appendix D Color Coordinates describes the 
HLS, RBG, and CMY systems of color coordinates used 
in the 4113 Computer Display Terminal* 

• Appendix E Bit Planes and Surfaces describes 
aspects of the display systems of the 4112 and 4113 
terminal s • 

$ Index contains a "Keyword in Context 11 index of 
the commands in Section 4. A Keyword in Context 
index contains an entry for each significant word in 
the command name for ease of locating a particular 
command or function . For example, the <Include-Copy- 
of ~Segment> command can be found under " C" , "I" , and 
"S" as follows : 

Include Copy of Segment 

Include Copy of Segment 
Include Copy of Segment 

It should also be noted that, since a majority of 
the 4110 Series commands begin with "Set, 11 the term 
"set" is not included as a keyword for index ing 
purposes . 



DIFFERENT VERSIONS OF 4110 SERIES TERMINALS 

All references in this manual to the TEKTRONIX 4112 Computer 
Display Terminal apply equally to the 4112A terminal . All 
references to the TEKTRONIX 4113 Computer Display Terminal 
apply equally to the 4 1 1 3A and 4113A30 terminals . All 
references to the TEKTRONIX 4114 Computer Display Terminal 
apply equally to the 4 114A, 41 14A30, 41 16A, and 4 1 16A3.0. The 
4 1 12A , 4113A and 4 1 1 4A terminals are newer versions of the 
4112, 4113, and 4114 terminals , respectively. The 4 1 16A 
responds to the same commands as the 4 1 1 4A , but uses a 
larger display. The 41 13A30, 4114A30 and 4116A30 terminals 
are desk configurations of the 4 1 1 3A , 41 14A and 4 1 1 6A 
terminals respectively . These desk configurations have some 
controls and indicators in positions d if f erent from those 
pictured in Figure 1-1. 
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MANUAL CONVENTIONS 

In Section 4 each command starts on a new page, and the 
command name appears at the top of the page. If the command 
is unique to a particular 4110 Series Terminal (4112, 4113, 
or 4114), the terminal number appears on the right-hand side 
of the page* If the command is option-dependent, the option 
number appears in this location in parentheses . 

RELATED DOCUMENTATION 

Other manuals which are available for the 4 110 Series 
terminals include : 

m introduction brochures 

• operator f s manuals 

• host programmer's manuals 

• service manuals ( for the terminal ) 

• and ( in some cases) manuals relating to specific 
options • 

Additional information on PLOT 10 Software which supports 
the 4 110 Series terminals is also available . 

Contact your local Tektronix office for a complete 1 ist of 
manuals which are available for your particular terminal . 
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Section 2 

COMMAND SYNTAX 



SYNTAX NOTATION 

All commands to the terminal are ultimately sent as a 
sequence of individual ASCII characters. However, to de- 
scribe each operation in terms of those individual charac- 
ters would be both tedious and confusing. Therefore, a 
number of notational conventions are used throughout this 
manual . 



Syntax Rules 



In this manual, command syntax is represented according to 
the following rules. The syntax symbols are summarized in 
Table 2-1 . Each of the symbols is described in detail in the 
following paragraphs . 



Table 2-1 
COMMAND SYNTAX SYMBOLS 



Rule 


Symbol 


Meaning 


1 


( ) 


Single ASCII characters 


2 


< > 


Expressions 


3 




Specific examples 


4 




Has the following syntax 


5 


or 


Al ternate 


6 


[ ] 


Optional item 


7 




Values which can be repeated n 
times 
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COMMAND SYNTAX 



Rule One . Individual ASCII characters sent to or from the 
terminal are enclosed in parentheses. 

Examples : 

(A) The ASCII uppercase "A" character . 

(a) The lowercase " a" character, 

(ESC) "Escape" control character. 

(DEL) "Delete" character (also called "rub out"). 
(US ) "Unit separator" control character . 
(SO) "Shift out" control character . 

The parentheses characters are an exception ; to decrease 
confusion , they are represented as follows : 

("(") "Left parenthesis" character . 

(")") "Right parenthesis" character . 



Rule Two . Expressions enclosed in "angle brackets" represent 
sequences of ASCII characters which might be sent to or from 
the terminal . 



NOTE 

You can find the exact syntax of any 
such "angle bracket" expression |by 
referring to Section 4 . 



For example , the following expressions , since they are 
enclosed in " angle brackets , " represent syntactic con- 
strue ts : 

<set-baud-rates> A command that sets the transmit and 

receive baud rates (data rates) for com- 
municating with the host computer. 
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<int> 



An integer number as encoded for 
transmission to the terminal • 



<xy> 



A pair of x- and y-coord inat es as encod- 
ed for transmission to the terminal as a 
part of a command . 



Rule Three . To represent specific ex amples of command s or 
other syntactic construe ts , specific values are includ ed 
between the angle brackets . For ex ample : 

<set- baud- rates : 1200, 1200> 

A command to set receiv ing and transmitting data rates to 
1200 baud (1200 bit s/ second ) . 

<int : -35> 

The number -35 , as encoded for transmission to the terminal . 
<xy : (0, 100)> 

The coord inate pair x = 0, y= 1 00 , as encoded for transmission 
to the terminal . 

The same notation may be used to express the meaning of 
parameters , especially in the more compl icated syntax defi- 
nitions . For instance , the meaning of the < set- baud- rate> 
command 1 s two parameters can be expressed as follows : 



Here , the ital ic ized expressions transmit- rate and receive- 
rate tell the meanings of the < int+> parameters . 

Rule Four . In defining the syntax of a command , the equal s 
s ign ( = ) means 11 has the following syn tax . " For example : 



<set-baud-rates> = (ESC)(N)(R) 

< int+ : tr ansmit-rate> 
<int+ : receiv e-rate> 



<.set-baud-rates> = (ESC) (N ) (R )<int+Xint+> 
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Rule Five, In syntax definitions , the word "or" means "or 
alternately." For example: 

<set-alphatext-fon.t> =(ESC)(SI) 

or (ESC) (SO) 



Rule Six . In syntax definitions, square brackets delimit 
items which may be omitted . For example: 

<int> = [<HiI>][<HiI>]<LoI> 

This could be expressed in words as, "An <int> consists of 
zero, one, or two <Hil>s, followed by a <LoI>." 



Rule Seven. Syntactic constructs which may be repeated any 
number of times are followed by three dots. For example: 

<fill-pattern-definition> ~ <begin-f ill-pattern> 

[ <pixel-def> . . . ] 
<end- fill- patter n> 

This could be expressed in words as, "A <f ill-pattern- 
def inition> consists of a < begin- f ill- pat tern > command, fol- 
lowed by zero or more <pixel-def> s , followed by an < end- 
f ill-pattern> command," 



Examples 



Since the <begin-segment> command is represented with "angle 
brackets," it has a syntax definition in Section 4. Section 
4 gives the <begin-segment> syntax as follows : 

<begin-segment> = (ESC) (S)(0)<int> 

This means that the < beg in- segment> command is sent to the 
terminal as three ASCII characters - "esc ape , " " uppercase 
S , " and "uppercase 0, " followed by an < int> parameter . 

Since the < int> parameter is represented with angle 
brackets , it too has a syntax definition in Section 4 . 
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A particular example of the < beg in- segment> command is the 
< beg in- segment : 1 > command. That can be represented as 

follows: 

<begin-segment : 1> = (ESC) (S ) (0 Xint : 1 > 

Referring to the Command Reference Manual's discussion of 
the <int> parameter type, notice that < int : 1 > is the single 
ASCII character for the digit 1: 

<int : 1> = (1 ) 

Thus, you can expand the < beg in- segment : 1 > command as 
follows: 

<begin-segment : 1> = (ESC) (S ) (0 Xint : 1> 

= (ESC) (S)(0)(1 ) 

Again, consider the < set- baud -rates: 600, 600> command. 
Section 4 gives the syntax for < set- baud- rate s> as follows: 

<set-baud-rates> = (ESC) (N ) (R )<int+Xint+> 

Referring to the discussion of < int+> in Section 4, you can 
expand the < set- baud -rates: 600, 600> command as follows : 

<set-baud-rates : 600, 600> 

= (ESC)(N)(R) <int+: 600> <int+: 600> 

= (ESC)(N)(R) (R)(<)(e)(8) (R)(<)(e)(8) 

Thus , a <set-baud-rates : 600 , 600> command is sent to the 
terminal as the following sequence of ASCII characters : 

(ESC) (N)(R)(e) (8)(e) (8) 



COMMAND SYNTAX 

All commands to the terminal are sent from the host computer 
as a sequence of ASCII characters . A few of these commands 
consist of a single character ; some are compr ised of two 
characters; however, most consist of three or more 
charac ter s . 
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One-Character Commands 

The following commands consist of only one ASCII character. 
< enter- alpha-mode> = (US) 
<enter- vector- mod e> = (GS) 
< en ter- marker- mod e> = (FS) 

Two-Character Commands 

Most commands consist of escape sequences -- sequences of 
ASCII characters beginning with the (ESC) character . A few 
of these command s consist of only two characters : 

<enab.le-4010-GIN> = (ESC) (SUB) 

< en ter- bypass- mod e> = (ESC) (CAN) 

<page> = (ESO(FF) 

<report-4010-status> = (ESC) (ENQ) 

<set-alphatext-font> = (ESCX(SI) or (S0)> 

<set-40l4~line-style> = (ESC)<char> 

<4010-hard~copy> = (ESC) (ETB) 

Commands of Three or More Characters 

Most of the terminal command s are esc ape sequences of three 
or more characters . These command s take the following 
format : 

1. The first character is (ESC) . This serves as a 
11 flag" to tell the terminal that the following 
characters compr is.e a command for it . 
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The next two characters comprise an op code to 
identify the command. 

After the op code there may be one or more 
parameters of the following types: 



< int> or < int+> 



< int- array> 



<real> 



<xy> 



A sequence of characters rep- 
resenting an integer number. 

An array of < int> parameters , 
including a "count" for the 
array sent as an < int> parame- 
ter at the beginning . (See the 
d iscussion of <array> parame- 
ter types in Section 4.) 

A sequence of two < int> 
parameters which together rep- 
resent a single real number : 

<real> = <int><int> 

(Exactly how these two < int> s 
represent a real number is 
described in Section 4 under 
the discussion of the <real> 
parameter type . ) 

A sequence of characters rep- 
resenting x- and y-coordinates 
for some location on the ter- 
minal 1 s screen . 



<char> 



<char-array> 
or <string> 



A single ASCII character in 
the range from (SP) to ( ~ ) : 
ASCII decimal equivalents from 
32 to 126. 

An array of <char> parameters , 
preceded by a count, expressed 
as an <int> parameter. 



/ 
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When the terminal is receiv ing the parameter for a command , 
it ignores any characters ( a) which are not valid characters 
for the parameter being received, and (b) which are not the 
"command terminator" characters: (ESC) , (US ) ; (GS ) , and 
( FS ) . For instance, most ASCII control characters are 
ignored; thus ( CR ) characters or other interline characters 
can be inserted within the command ' s parameter s with no ill 
effect, (This is useful if the parameter is a very long 
<string> or < int- arr ay> . ) 

4 . Finally , the command is " terminated" — it comes 
to an end . A command can be terminated in two 
ways : 

o The command ends when all its parameters have 
been sent to the terminal . 

o A command may be terminated early ( before all 
its parameter s have been sent) by send ing any 
of the following characters: 

(ESC) . A command end s with the (ESC) character 
that begins another command . 

(US), (GS), and (FS). A command ends whenever 
the terminal receives a (US ) , (GS ) , or (FS) 
character . These characters have their usual 
effects as <enter-alpha-mode> , <enter-vector- 
mode>, and < enter- marker- mod e> commands. 



Defaults for Missing Parameters 

When a command is terminated early, the 4114 assigns def aul t 
values to the missing parameters. These def aul ts are usual- 
ly: 

o for < int> parameters 
o 0.0 for <real> parameters 
o (0,0) for <xy> parameters 
o (NUL) for <char> parameters 

o an array of elements for <array> parameters 
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Assigning (NUL) as the default for missing <char> parameters 
is an ex ception to the rule that <char> parameters must 
represent characters in the range from (SP) to ( ~ ) . 



NOTE 

Some commands are exceptions . When those 
commands are terminated early , the ter- 
minal assigns other defaults than those 
just listed . To determine the default 
value for a particular command , consult 
the description of that command in Sec- 
tion 4 . 



PARAMETER TYPES 

Parameters for esc ape- sequence command s may be variables of 
several different data types. Each such data type has its 
own syntax and coding scheme . The parameter types are : 



<int> and <int+> 



< int-err ay> and < int+-array> 



Integer numbers are sent to 
the terminal as < int> or 
< int+> parameters . These two 
parameter types have the same 
syntax and the same coding 
scheme ; they d if fer only in 
the range of valid values . 
<In t> parameters represent in- 
tegers in the range from 
-32768 to +32767. <Int+> par- 
ameters represent integers 
from to +65535* 

An array of integers consists 
of an < int> (or < int+> ) tell- 
ing how many items are in the 
array , followed by <int>s for 
each of the items in the ar- 
ray. 
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<real> 



<char> 



< str ing> or <char-array> 



<xy> 



<Real> parameters represent 
numbers which c an assume frac- 
tional values. Each <real> 
parameter consists of two 
< int> parameters. The first 
<int> represents a number, 
while the second < int> repre- 
sents a power of two by which 
that number is to be multi- 
plied, 

<Real> parameters can assume 
values from -32767 . to 
+32767. 0, 

<Char> parameters are individ- 
ual ASCII characters in the 
range from (SP) to ( ~ ) . (They 
have decimal equivalents in 
the range from 32 to 126.) 
They represent the displayable 
ASCII characters . 

<Str ing> s , or <char-array> s , 
consist of an < int> (or 
< int+> ) tell ing how many char- 
acters are in the str ing , fol- 
lowed by <char>s for each of 
those characters . 

An ( x , y ) coord inate pair as 
encoded for transmission to 
the terminal . The < xy> parame- 
ter syntax is also described 
in Section 4 . 



<Int> and <Int+> Parameters 



The <int> and < int+> parameter types have the same packing 
scheme and the same syntax . These parameter types differ 
only in the range of valid values : -32768 to +32767 f or 
< int> parameters , and to 65535 for < int+> parameters . The 
< int> and < int+> syntax is as follows : 

<int> = [<HiI>] [<HiI>3 <LoI> 

<int+> = [<HiI>] [<HiI>] <LoI> 
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where 



<HiI> = an ASCII character in the range from ( @) to 
(DEL) - except that the character sequence 
(ESC)(?) may be used instead of (DEL). 

<LoI> = an ASCII character in the range from (SP) to 
(?). 



Example 

Figure 2-1 shows the packing scheme , using the number +31416 
as an example. 



1 . The number to be sent is represented as a 1 6-bit signed binary numeral: 



+ 31416 10 = +0111101010111000 2 

2. That binary numeral is arranged in groups of 6, 6, and 4 bits: 

+ ,0 1 1 1 1 0, ,1 1 1 1, ,1 0, 

3. If the most-significant six bits are all zero, then the first < Hil> character may be omitted. In this case, they 
are not all zero, so they are used (together with a "tag" bit of 1 ) to form the first < Hil> character: 

+ 10 111101 10 10 11 10 
first <Hil> = 11101/1101 = (~) 

4. If the most-significant twelve bits are all zero, then BOTH < Hil> characters may be omitted. That is not the 
case in this example. The second < Hil> character is formed from the next least-significant six bits: 



+ 11110 
second <Hil> = 



10 10 11 

~r~ 



101011 



1000 

(k) 



The < Lol> character's least-significant bits are the four least-significant bits of the binary numeral. The 
fifth least-significant bit is 1 if the number is positive, and zero if it is negative. The two high-order bits ("tag 
bits") are "01 " so as to make the < Lol> character fall in the range from (SP) to (?): 



11110 10 10 11 1 1 oool 
3_ 



1 



JZ 



10 



<Lol> 

6. The characters to be sent to the terminal, then, are (^XkXS): 

<int : 31416> = r)(k)(8) 



(8) 



Figure 2-1 . Example of <Int> and <Int+> Packing Scheme. 
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Table 2-2 lists several examples of <int> parameters., (For a 
more complete list, see Appendix B.) 



Table 2-2 
EXAMPLES OF <INT> PARAMETERS 



Hum hpr 


^ T H t" ^ Par 1 prn pfpr 

XI U U/ I 01 0111 U vv I 





(0) 


i 

1 


( 1 ) 




(? ) 


3 


(3) 


4 


(4) 


D 




c. 



vo ; 


7 


(7) 


8 


(8) 






10 


(:) 


1 1 


(;) 


15 


(?) 


16 


(A)(0) 


17 


(A)(1) 


-1 


(!) 


-2 


(") 


-15 


(?) 


-16 


(A)(SP) 


-17 


(A)( !) 


1023 


(DEL ) ( ?) or (ESC)(?)(?) 


1 024 


(A)(@)(0) 


1025 


(A)(6) CI ) 


-1024 


(A)(@)(SP) 


-1025 


(A)(0)( !) 
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<Int~Array> Parameters 



Some commands take < int-array> (or < int+-array> ) parameters . 
These consist of sequences of <int> (<int+>) parameters. The 
first <int> or <int+> tells how many items are in the array. 
Subsequent < int> s represent the ind iv idual array items . 

For instance the array of integers (1, 5, -1 , 1 6 ) would be 
sent to the terminal as follows : 

<int-array: (1,5,-1,16) = <int: 4> { the count of 4 } 

<int: 1> <int: 5> <int: -1> <int: 16> 

= (4) (1 ) (5) (!) (A)(0) 

For more information on <int> and <int+> parameters , see the 
parameter description in Section 4. 



<Real> Parameters 



A " real" number is a variable which may assume non- integer 
( that is, fractional ) values . Real numbers between -32767.0 
and +32767.0 are sent to the terminal as <real> parameters . 
These consist of a pair of < int> s . The first <int> repre- 
sents a number ; the second < int> represents the power of two 
by which that number is to be mul tipl ied . 

For instance , the number 3.25 may be represented as 13 
mul tipl ed by two raised to the power -2. Thus , 

<real : 3.25> = <int : 13> <int : -2> 
= (=) (") 

For more information about <real> parameters , see the 
description in Section 4 . Included there is an example of a 
routine which send s < real> parameters to the terminal . 
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<Char> Parameters 



The <char> parameter type represents d ispl ayable ASCII char- 
acters. Each <char> parameter is a single ASCII character in 
the range from (SP) to (~). (The decimal equivalent of a 
< char> character is in the range from 32 to 126.) 



<Str ing> or <Char-Array> Parameters 



Strings, or arrays of d ispl ayable ASCII characters ,• are sent 
to the terminal as <char-array> parameters . Each such 
parameter consists of an < int> (or < int+> ) telling how many 
items are in the array , followed by one <char> for each 
array item. For more information , see the description in 
Section 4. 



<Xy> Parameters 



The <xy> parameter type represents spatial coord inates . <Xy> 
parameters are sent as a group of one to five ASCII 
characters. (The packing scheme used is the same as that 
used for earlier TEKTRONIX terminals.) The x- and y-coordi- 
nates in an <xy> parameter can range from to 4095. For 
more details , see the parameter description in Section 4 . 



Report Parameter Types 



The parameter types described so far are for sending command 
parameters to the terminal . When the terminal sends messages 
back to the host computer , it packs the information, in a 
d if ferent format . Thus, for each host- to- terminal parameter 
type there is a corresponding terminal- to- host parameter 
type. Table 2-3 lists the types . 
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Table 2-3 

HOST-TO-TERMINAL AND TERMINAL-TO-HOST PARAMETER TYPES 



Data 

To Be Sent 


Host-To-Terminal 
Parameter Type 


Terminal-To-Host 
Parameter Type 


Integer 
(-32768 to 
+32767) 


<int> 


<int-repor t> 


In teger 

(0 to 65535) 


<int+> 


<int-repor t> 


Array of 
Integers 


<int-array> 
or < int+-array> 


<in t- array- re por t> 


Real 

(-32767.0 to 
+32767.0) 


< real> 


<real-repor t> 


Di spl ayable 
Character 


<char> 


<char-repor t> 


String of 
Characters 


<str ing> 

or <char-array> 


<str ing-report> 


Spatial 
Coordinates 


<xy> 


<xy-repor t> 



For more information on < int-repor t> s , < in t- array-re port> s , 
<real-report>s , <char-repor t> s , <string-report>s , and <xy- 
report>s , see those descriptions in Section 4. 
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Section 3 



DIRECTORY OF COMMANDS AND 
OTHER SYNTACTIC CONSTRUCTS 



PARAMETERS AND MESSAGE TYPES 

Parameters Sent To the Terminal 



Name SETUP Name Page 

< Array> Parameter Types 4-5 

< Char> Parameter Type . . . 4-51 

< Delete-Equivalent> Syntactic Construct . 4-70 

<lnt> and <lnt+ > Parameter Types . . . .. 4-179 

< Real> = < int> < int> 4-252 

<String> = < char-array> = <int+ > [<char> ...] 4-5 

<Xy> = [< HiY>] [<Extra> [< LoY>] < HiX>] < LoX> 4-604 

Reports Sent To the Host 

Name SETUP Name Page 

< Array-Report> Parameter Types 4-7 

< Char-Report> Parameter Types 4-52 

< Device-Status-Report> Message Type 4-79 

<EOL-String> 4-135 

<EOM-lndicator> = < EOL-string> or < block-mode-EOM> 4-138 

< GIN-Locator-Report> 4-150 

< G!N-Pick-Report> 4-152 

< GIN-Report-Sequence> Message Type 4-155 

< GIN-Stroke-Report> 4-161 

< int-Report> = < Hil-report> < Hil-report> < Lol-report> 4-186 

< lnt-Array-Report> 4-190 

< Port-Status-Report> Message Type 4-236 

< Real-Report> = < int-report> < int-report> 4-254 

< Segment-Status-Report> Message Type 4-295 

< String-Report > 4-581 

< Xy-Report> 4-604^ 

< 401 0-GIN-Report> Message Type 4-610 

< 4953-Tablet-GIN-Report> Message Type 4-618 
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General Terminal Control 



Name SETUP Name Page 

<Cancel> = (ESC) (KMC) 4-48 

CANCEL Key 4-50 

< lgnore-Deletes> = (ESC)(K)(I)< int> 4-175 

LOCAL Key 4-197 

<Reset> = (ESCMKMV) 4-282 

SETUP Key 4-573 

<Set-Edit-Chars> = (ESC)(K)(Z)< intx int> EDITCHARS ... 4-385 

STATUS Command STATUS 4-578 

Keyboard Control and Macro Definitions 

Name SETUP Name Page 

<Define-Macro> = (ESC)(K)(D)< int> < int-array> DEFINE 4-65 

< Expand-Macro> = (ESC)(K)(X)<int> 4-143 

< Key-Execute-Character> 4-1 91 

< Set-Key-Execute-Character> = (ESC)(K)(Y)<int> KEYEXCHAR .. 4-432 

< Lock-Keyboard> = (ESC)(K)(L) LOCKKEYBOARD . .. 4-1 98 

< Lock-Viewing-Keys> = (ESC)(R)(J)< int> 4-200 
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Controlling the Display 

Name SETUP Name Page 

< Enable-Dialog-Area> = (ESC)(K)(A)< int> DAENABLE .... 4-99 

<CRLF> - (ESC)(K)(R)<int> CRLF 4-63 

<Set-Echo> = (ESC)(K)(E)<int> ECHO 4-383 

<Hardcopy> = (ESC)(K)(H)<int> 4-170 

< 401 0-Hardcopy> = (ESO(ETB) 4-61 3 

HARD COPY Key 4-1 72 

< LFCR> = (ESC)(K)(F)< int> LFCR 4-1 94 

<Set-Margins> = (ESC)(K)(M)<int> MARGIN 4-441 

<Page> = (ESC)(FF) 4-211 

PAGE Key 4-213 

< Renew-View> = (ESC)(K)(N)< int> 4-262 

<Set-Graphics-Area-Writing-Mode> = (ESC)(M)(G)<int> GAMODE 4-419 

< Set-Page-Full-Action> = (ESC)(K)(P)< int> 4-445 

<Set-Snoopy-Mode> = (ESC)(K)(S)<int> SNOOPY 4-552 

<Set-Fixup-Level> = (ESC)(R)(F)< int> FIXUP 4-399 

<Set-Error-Threshold> = (ESC)(K)(T)<int> ERRORLEVEL . 4-397 

Dialog Area 

Name SETUP Name Page 

CLEAR Key 4-54 

<Clear-Dialog-Scroll> = (ESC)(L)(Z) 4-55 

DIALOG Key 4-85 

< Enable-Dialog-Area> = (ESC)(K)(A)< int> DAENABLE .... 4-99 

<Set-Dialog-Area-Buffer-Size> = (ESC)(L)(B)<int+ > DABUFFER .... 4-362 

<Set-Dialog-Area-Chars> = (ESC)(L)(C)<int+ > DACHARS 4-364 

<Set-Dialog-Area-lndex> = (ESC)(L)(I)< int+ > < int-f > < int+ > DAINDEX ...... 4-366 

< Set-Dialog-Area-Lines> = (ESC)(L)(L)<int+ > DALINES 4-370 

< Set-Dialog-Area-Position = (ESC)(L)(X)<xy> DAPOSITION ..4-372 

< Set-Dialog-Area-Surface> = (ESC)(L)(S)< int> DASURFACE . . . 4-374 

<Set-Dialog-Area-Visibility> = (ESC)(L)(V)<int> DAVIS 4-376 

< Set-Dialog-Area- Writing-Mode> = (ESC)(L)(M)<int> DAMODE 4-379 
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Host Port Communications 

Name SETUP Name Page 

BREAK Key 4-44 

<Copy> = (ESC)(J)(C)< string> < string> < string> COPY ......... 4-56 

< Enter-Bypass-Mode> = (ESC) (CAN) 4-129 

< lgnore-Deletes> = (ESC)(K)(l)<int> 4-175 

< Prompt-Mode> = (ESC)(N)(M)< int> PROMPTMODE 4-240 

< Set-Baud-Rates> = (ESC)(N)(R)<int+ ><int+ > BAUDRATE .... 4-321 

< Set-Break-Time> = (ESC)(N)(K)< int+ >................. BREAKTIME . . . 4-352 

< Set-Bypa8S-Cancel-Char> = (ESC)(N)(U)< int> BYPASSCANCEL ... 4-254 

<Set-EOF-String> = (ESC)(N)(E)< int-array> EOFSTRINQ ... 4-388 

<Set-EOL-String> = (ESC)(N)(T)< int-array> EOLSTRING ... 4-391 

< Set-EOM-Chars> = (ESC)(N)(C)< int> < int> EOMCHARS . . . 4-393 

<Set-Flagging-Mode> = (ESC)(N)(K)<int>. .". .......... FLAGGING .... 4-402 

<Set-Parity> = (ESC)(N)(P)< int> PARITY 4-455 

<Set-Prompt-String> = (ESC)(N)(S)<int-array> PROMPTSTRING ... 4-483 

<Set-Queue-Size> = (ESC)(N)(Q)< int+ > QUEUESIZE ... 4-485 

<Set-Report-Max-Line-Length> = (ESC)(l)(L)<int+ > RLINELENGTH . 4-492 

<Set-Stop-Bits> = (ESC)(N)(B)<int> STOPBITS 4-524 

< Set-Transmit-Delay> = (ESC)(N)(D)< int+ > XMTDELAY .... 4-552 

< Set-Transmit-Rate-Limit = (ESC)(N)(L)< int+ > XMTLIMIT 4-554 



Mode Switching 

Name SETUP Name Page 

< Enter-Alpha-Mode> = (US) 4-127 

< Enter-Marker-Mode> = (FS) 4-132 

< Enter-Vector-Mode> = (GS) 4-1 33 
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Graphic Primitives and Primitive Attributes 

Lines 



Name SETUP Name Page 

< Enter-Vector-Mode> = (GS) 4-133 

< Move> = (ESC) (L) (F) < xy> 4-205 

<Draw> = (ESC)(L)(G)<xy> 4-95 

<Set-Line-lndex> = (ESC)(M)(L)< int> 4-434 

< Set-Line-Style> = (ESC)(M)(V)< int> . 4-436 

< Set-401 4-Line-Style> = (ESC)<char> 4-571 

< Set-Line-Width> = (ESC)(M)(W)< int> 4-439 

Markers 

Name SETUP Name Page 

< Enter-Marker-Mode> = (FS) 4-1 32 

< Draw-Marker> = (ESC) (L) (H) 4-97 

< Set-Marker-Type> = (ESC)(M)(M)< int> 4-443 

Graphtext 

Name SETUP Name Page 

< Graphic-Text> = (ESC)(L)(T)< string> 4-1 65 

< Set-Graphtext-Font> = (ESC)(M)(F)< int> 4-421 

<Set-Graphtext-Font-Grid> = (ESC)(S)(G)< int> < int> < int> 4-424 

<Set-Graphtext-Precision> = (ESC)(M)(G)<int> 4-427 

< Set-Graphtext-Rotation> = (ESC) (M)(R)< real > 4-429 

< Set-Graphtext-Size> = (ESC)(M)(C)< int> < int> < int> 4-430 

<Set-Text-lndex> = (ESC)(M)(T)< int> 4-550 
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Alphatext 



Name SETUP Name Page 

<Enter-Alpha-Mode> = (US) .. ... 4-127 

< Set- Alphatext-Font> = (ESC) (SI) or (ESC) (SO) . . 4-309 

< Set-Alphatext-Size> = (ESC)(M)(Z)< int> < int> < int> ALPHASIZE .... 4-31 

< Set-401 4-Alphatext-Slze> = (ESC)< (8) or (9) or (:) or (;)> 4-570 

<Set-Text-lndex> = (ESC)(M)(T)<int> 4-550 

Panels (41 1 2 and 41 1 3) 

Name SETUP Name Page 

< Begin-Panel-Boundary> = (ESC)(L)(P)< int> 4-1 7 

< End-Panel> = (ESC)(L)(E) 4-1 24 

< Select-Fill-Pattern > = (ESC)(M)(P)<int> 4-301 

<Set-Panel-Filling-Mode> = (ESC)(M)(S)< int-t- > < int+ > < int+ > 4-447 

Other Graphic Primitives 

Name SETUP Name Page 

< lnclude-Copy-Of-Segment> = (ESC)(L)(K)< int> 4-177 

<Set-Pick-ID> = (ESC)(M)(I)< int> 4-459 

< Set-Qraphics-Area-Writing-Mode> = (ESC)(M)(G)< int> GAMODE 4-419 
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Panels (41 1 2 and 41 1 3) 

Drawing Panels 



Nam© SETUP Name Page 

<Select-Fill-Pattern> = (ESC)(M)(P)< int> 4-301 

< Set-Panel-Filling-Mode> = (ESC)(M)(S)< int> < int> < int> 4-447 

< Begin-Panel-Boundary> = (ESC)(L)(P)<xyxint> 4-17 

<End-Panel> = (ESC)(L)(E) 4-124 

Defining Fill Patterns for Panels 

Name SETUP Name Page 

<Begin-Fill-Pattern> = (ESC)(M)(D)< int> < int> < int> < int> 4-9 

<End-Fill-Pattern> = (ESC)(M)(E) 4-122 

Graphtext 
Displaying Graphtext 

Name SETUP Name Page 

<Graphic-Text> = (ESC)(L)(T)<string> 4-165 

<Set-Graphtext-Font> = (ESC)(M)(F)<int> 4-421 

< Set-Graphtext-Precision> = (ESC)(M)(Q)<int> 4-427 

<Set-Graphtext-Rotation> = (ESC) (M)(R)< real > 4-429 

< Set-Graphtext-Size> = (ESC)(M)(C)< int> < int> < int> 4-430 

Defining Graphtext Characters 

Name SETUP Name Page 

< Set-Graphtext-Font-Grid> = (ESC)(S)(G)< int> < int> < int> 4-424 

< Begin-Graphtext-Character> = (ESC)(S)(T)<intxint> 4-14 

< End-Graphtext-Character> = (ESC)(S)(U) 4-1 23 

< Delete-Graphtext-Character> = (ESC)(S)(Z)<intxint> 4-73 
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Segments 
Defining Segments 



Name SETUP Name Page 

<Set-Pivot-Point> - (ESC)(S)(P)<xy> ... 4-461 

< Begin-Segment> = (ESC)(S)(0)< int> . . v.. ......... . . . . . 4-29 

< End-Segment> - (ESC)(S)(C) 4-126 

<lnc!ude-Copy-of-Segment> = (ESC)(L)(K)< int> 4-177 

< Delete-Segment> - (ESC)(S)(K)< int> 4-75 

< Rename-Segment> = (ESC)(S)(R)<intxint> 4-260 

Setting Segment Attributes 

Nam® SETUP Name Page 

< Set-Segment-Class> = (ESC)(S)(A)< int> < int-array> < int-array> 4-498 

< Set-Segment-Detectability> = (ESC)(S)(D)< int> <int> 4-501 

< Set-Segment-Display-Priority> = (ESC)(S)(S)< int> < int> 4-503 

< Set-Segment-Highlighting> = (ESC)(S)(H)<intxint> 4-505 

< Set-Segment-lmage-Transform> = (ESC)(S)(I)< int> < real> < real> < real> < xy> . . ...... 4-508 

< Set-Segment-Position> = (ESC)(S)(X)<intxxy> 4-512 

<Set-Segrrsent-Visibi!ity> = (ESC)(S)(V)< int> < int> 4-515 

< Set-Segment-Writing-Mode> = (ESC)(S)(M)< int> < int> 4-51 8 
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Segment Classes 

Name SETUP Name Page 

< Set-Segment-Class> = (ESC)(S)(A)< int> < int-array> < int-array> 4-498 

< Set-Current-Matching-Class> = (ESC) (S) (L) < i nt-array > < i nt-array > 4-360 

Reporting Segment Settings to the Host 

Name SETUP Name Page 

< Report-Segment-Status> = (ESC)(S)(Q)< int> < char-array> 4-273 

< Segment-Status-Report> Message Type 4-295 

Displaying Segments (41 1 2 and 41 1 3) 

Name SETUP Name Page 
<Set-Fixup-Level> = (ESC)(R)(F)<int> FIXUP 4-399 

Saving Segments on Peripheral Devices 

Name SETUP Name Page 

<Save> = (ESC)(J)(V)< string> < int> < string> < string> SAVE 4-288 
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GIN (Graphic Input) 
Enabling and Disabling GIN 



Name SETUP Name Page 

<Enable-GIN> = (ESC)(l)(E)<intxint+ > 4-103 

<Enable-4010-GIN> = (ESC) (SUB) 4-111 

< Enable-4953-Tablet-GIN> = (ESC)(!)< enable-code-character> 4-115 

<Disable-GIN> = (ESC)(l)(D)<int> 4-92 

< Disable-4953-Tablet-Gin> = (ESC)(!)< disable-code-character> 4-94 

<Report-GIN-Point> = (ESC)(I)(P)< int> 4-268 

Setting GIN Parameters 

Name SETUP Name Page 

<Set-GIN-Cursor> = (ESC)(I)(C)< intx int> 4-405 

< Set-GIN-Gridding> = (ESC)(I)(G)< int> < int> < int> GRIDDING 4-409 

<Set-GIN-lnking> = (ESC)(l)(l)<intxint> 4-412 

< Set-GIN-Rubberbanding> = (ESG)(I)(R)< int> < int> 4-41 4 

< Set-GIN-Stroke-Filtering> = (ESC)(I)(F)< int> < int> < int> 4-41 6 

<Set-Pick-Aperture> = (ESC)(l)(A)<int> 4-457 

GIN Report Messages 

Name SETUP Name Page 

< GIN-Report-Sequence> Message Type 4-1 55 

< GIN-Locator-Report> 4-150 

<GIN-Pick-Report> 4-152 

<GIN-Stroke-Report> 4-161 

< 4953-Tablet-Gin-Report> Message Type — 4-618 
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DIRECTORY 



Setting Parameters for Report Messages 



Name SETUP Name Page 

< Set-Report-EOM-Frequency> = (ESC)(I)(L)< int> REOM 4-488 

< Set-Report-Max-Line-Length> = (ESC)(l)(L)<int> RLINELENGTH . 4-492 

< Set-Report-Sig-Chars> = (ESC)(I)(S)< intx intx int> 4-496 

Non-GIN Report Messages 
Requesting Non-GIN Reports 

Name SETUP Name Page 

< Report-Device-Status> = (ESC)(J)(Q)<string> . . 4-264 

< Report-Errors> = (ESC)(K)(Q) 4-266 

< Report-Port-Status> = (ESC)(P)(Q)< string> < string> < string> 4-271 

< Report-Segment-Status> = (ESC) (S)(Q)< intx char-array> 4-273 

< Report-Terminal-Settings> = (ESC)(I)(Q)< char> < char> 4-277 

<Report-4010-Status> = (ESO(ENQ) 4-281 

Report Messages 

Name SETUP Name Page 

< Device-Status-Report> Message Type 4-79 

< Error-Report> Message Type 4-140 

< Port-Status-Report> Message Type 4-236 

< Segment-Status-Report> Message Type — 4-295 

< Terminal-Settings-Report> Message Type 4-582 

< 401 0-Status-Report> Message Type 4-614 

Setting Parameters for Report Messages 

Name SETUP Name Page 

<Set-Report-EOM-Frequency> = (ESC)(I)(L)< int> REOM 4-488 

<Set-Report-Max-Line-Length> = (ESC)(l)(L)<int> RLINELENGTH. 4-492 

< Set-Report-Sig-Chars> = (ESC)(I)(S)< intx intx int> 4-496 
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Surfaces (41 12,411 3) 



Name SETUP Name Page 

< Set-Background-Gray-Level> = (ESC)(R)(B)<int> . 4-31 6 

< Set-Background-Color> = (ESC)(T)(B)< int> < int> < int> . 4-314 

<Set-Surface-Definitions> = (ESC)(R)(D)< int-array> . . ... 4-529 

< Set-Surface-Gray-Levels> = (ESC)(R)(G)< int-array> 4-534 

< Set-Su rf ace-Color-Map> = (ESC)(T)(G)< int> < int-array> 4-525 

< Set-Surface-Priorities> = (ESC)(R)(N)< int-array> 4-540 

< Set-Surface-Visibility> = (ESC)(R)(I)< int-array> 4-543 

Multiple Views (41 1 2, 41 1 3) 

Defining and Selecting Views 

Name SETUP Name Page 

<Select-View> = (ESC)(R)(C)< int> 4-306 

< Delete-View> = (ESC)(R)(K)< int> 4-77 

< Set-View- Attributes> = (ESC)(R)(A)< int> < int+ > < int+ > 4-556 

< Set-Viewport > = (ESC)(R)(V)<xyxxy> 4-563 

< Set-Window> = (ESC)(R)(W)<xyxxy> 4-566 

NEXTVIEW Key 4-207 

<Renew-View> = (ESC)(K)(N)<int> 4-262 

ZOOM and PAN Operations 

Name SETUP Name Page 

<Set-Window> = (ESC)(R)(W)<xyxxy> 4-566 

PAN Key 4-214 

ZOOM Key 4-607 

VIEW Key 4-596 

NORMAL Key 4-208 

OVERVIEW Key 4-209 

RESTORE Key 4-283 

< Lock-Viewing-Keys> = (ESC)(R)(J)< int> 4-200 
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Con! rolling a Viewport's Border 



Name SETUP Name Page 

<Set-Border-Visibility> = (ESC)(R)(E)< int> 4-350 

BORDER Key 4-43 

Ink Colors (4112, 4113) 

<Set-Text-lndex> = (ESC)(M)(T)< int> 4-550 

<Set-Line-!ndex> = (ESC)(M)(L)< int> 4-434 

< Set-Background-Gray Level> = (ESC)(R)(E)< int> 4-316 

< Set-Background-Color> = (ESC)(T)(B)< int> < int> < int> 4-314 

< Set-Surface-Gray-Levels> = (ESC)(R)(G)< intx int-array> 4-534 

< Set-Surface-Color-Map> = (ESC) (T)(G)< intx int-array> 4-525 

Pixel Operations (41 12, 411 3) 
Initialization 

Name SETUP Name Page 

< Begin-Pixel-Operations> = (ESC)(R)(U)< int> < int+ >< int+ > 4-23 

< Set-Pixel- Viewport > = (ESC)(R)(S)<xyxxy> 4-465 

< Set-Pixel-Beam-Position > = (ESC)(R)(H)<xy> 4-463 

Data Transfer 

Name SETUP Nam® Page 

< Pixel-Copy> = (ESC) (R)(X)< int> < xy> < xy> < xy> 4-218 

< Raster-Write> = (ESC)(R)(P)< int> < char-array> 4-244 

<Runlength-Write> = (ESC)(R)(L)< int-h -array> 4-285 

<Rectangle-Fill> = (ESC)(R)(R)<xyxxy>< int-h > 4-255 

<Save> = (ESC)(J)(V)< string> < int> < string> < string> 4-288 
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Option 01 (Half Duplex and Block Mode) 



Half Duplex 



Name SETUP Name Page 

<Set-Duplex-Mode> = (ESC)(0)(D)<lnt> DUPLEX 4-381 

Block Mode 



Name SETUP Name Page 

< Arm-For.-Block-Mode> = (ESC)(0)(B)< int> BLOCKMODE . . 4-2 

< Set-Block-Continue-Chars> = (ESC)(0)(C)< int> < int> BCONTINUECHARS 4-325 

<Set-Block-End-Chars> = (ESC)(0)(E)< intx int> BENDCHARS .. 4-327 

<Set-Block-Headers> = (ESC)(0)(H)< int-arrayx int-array> BHEADERS .... 4-329 

<Set-Block-Length> = (ESC)(0)(S)<intXint> BLENGTH 4-333 

< Set-Block-Line-Length> = (ESG)(0)(L)<int> BLINELENGTH . 4-334 

< Set-Block-Master-Chars> = (ESC)(0)(M)< int> < int> BMASTERCHARS . . . 4-336 

< Set-Block-Non-Xmt-Chars> = (ESC)(0)(N)< int-array> < int-array> . BNONXMTCHARS .. 4-338 

< Set-Block-Packing> = (ESC)(0)(P)< intx intx intx int> BPACKING .... 4-341 

< Set-Block-Timeout> = (ESC)(0)(T)< int> BTIMEOUT .... 4-348 
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Peripheral Devices 

Standard 41 1 0-Series Peripheral Support 

Name SETUP Name Page 

<Copy> = (ESC)(J)(C)< string> < string> < string> COPY 4-56 

< Report-Device-Status> = (ESC)(J)(Q)<string> '.. 4-264 

<Spool> = (ESC)(J)(S)< string> < string> < string> SPOOL 4-574 

<Stop-Spooling> = (ESC)(J)(E) . STOP 4-579 

<Load> = (ESC)(J)(L)<string> LOAD 4-195 



Option 1 (Three Port Peripheral Interface) 

Name SETUP Name Page 

<Map-lndex-To-Pen> = (ESC)(P)(I)< string> < int> < int> 4-202 

<Plot> = (ESC)(P)(L)<string> : PLOT 4-222 

<Port-Assign> = (ESC)(P)(A)< string> < string> < int> PASSIGN ...... 4-228 

< Port-Copy> = (ESC)(P)(C)< string> < string> < string> PCOPY 4-233 

<Report-Port-Status> = (ESC)(P)(Q)<string> PORTSTATUS . 4-271 

<Set-Port-Baud-Rate> = (ESG)(P)R)<string><int> PBAUD 4-467 

<Set-Port-EOF-String> = (ESC)(P)(E)<string>< int-array> PEOF 4-469 

<Set-Port-EOL-String> = (ESC)(P)(M)<string>< int-array> PEOL .......... 4-471 

<Set-Port-Flagging-Mode> = (ESC)(P)(F)< string> < int> < int> < int> . . . . PFLAG 4-473 

< Set-Port-Parity> = (ESC)(P)(P)<stringxint> PPARITY ...... 4-476 

<Set-Port-Stop-Bits> = (ESC)(P)(B)< string> < int> < int> PBITS 4-480 
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Options 1 3 and 1 4 (Graphics Tablet) 



Name SETUP Name Page 

<Enable-GIN> = (ESC)(l)(E)<intxint+ > 4-103 

< Enable-4953-Tablet-GIN> = (ESC)(!)<char> 4-115 

< Disable-GIN> = (ESC)(I)(D)< int> 4-92 

< Disable-4953-Tablet-GIN> = (ESC)(!)< char> 4-94 

< Set-GIN-Stroke-Filtering> = (ESC)(I)(F)< int> < int> < int> TBFILTER 4-41 6 

< Set-Tablet-Header-Characters > = (ESC)(I)(H)< int> TBHEADERCHARS . . 4-545 

< Set-Tablet-Status-Strap> = (ESC)(I)(T)< int> TBSTATUS .... 4-548 



Options 42 and 43 (Flexible Disk Drives) 

Name SETUP Name Page 

< Format-Volume> = (ESC)(J)(F)< string> < int> FORMAT 4-146 

< Directory> = (ESC)(J)(D)< string> < string> < string> DIRECTORY ... 4-86 

<Copy> = (ESC)(J)(C)< string> < string> < string> COPY ......... 4-56 

< Save> = (ESC)(J)(V)< string> < int> < string> < string> SAVE 4-288 

<Spool> = (ESC)(J)(S)< string> < string> < string> SPOOL 4-574 

< Stop-Spooling> = (ESC)(J)(E) STOP 4-579 

< Report-Device-Status> = (ESC)(J)(G)<string> 4-264 

< Load> = (ESC)(J)(L)<string> LOAD 4-195 

<Delete-File> = (ESC)(J)(K)<string> DELETE 4-71 

<Rename-File> = (ESC) (J) (R)<string>< stringxstring> .............. . RENAME ...... 4-257 
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ALPHABETICAL LISTING 



This section lists all the 4110 commands , as well as other 
message formats , data formats , parameter types ( < int> , 
<string> , etc . ) and reports sent to the host ( <gin-repor t- 
sequence> , <gin-locator-report> , etc • ) . For each command , 
this section includes a description of its syntax , of what 
it does , and of the errors that may be detected while 
executing it . 

If you do not know the name of a command , you may find the 
name by referring to Section 3, "Directory of Commands . " In 
general , the names of commands are verbs expressing the 
actions which those command s perform . Examples are <set- 
baud-rates> , <set-line-index> , and <enable-GIN> . Parameters 
for command s , and other messages or strings which are not 
themselves commands, have names which are nouns . Examples 
are <xy> , < int> , < int-repor t> , and <panel-definition>. 
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<Activate-LPOS> Command 

SETUP Mode Name: LPOS 



Option 42 f 43 



SYNTAX 

<activate-LPOS> = (ESC) ( J ) (B) 



Description 

This command activates the 11 local programmability" operating 

system . If the operating system has not been 'loaded ( is not 
resident in terminal memory) y then' this- command causes it to 
be loaded from a file named f LPS. SYS 1 s located on a local 
programmability disk mounted in drive zero* If this file i-s^ 
not founds an error is detected and reported/ 

If the operating system is resident ? but - has been deactivat- 
ed with ^the local programmability SLEEP command (see the 
4110 Series CP/M-86 System Overview Manual for information 
on the SLEEP command ) , this command reactivates the operat- 
ing system so that it resumes operating where it left off. 

When this command is received from a host , the operating 
system is activated immediately . When this command is issued 
f rom Setup mode , the operating system is activated but Setup 
is not disabled . Setup mode supersedes local programmabil i- 
ty , so that you must exit Setup mode before local programs 
can run . You can enter Setup mode as often as you want f but 
use of local programs is suspended until you exit Setup 
mode . 

When local programmability is activated , the LED in the 
LOCAL key is turned on and further communications from the 
host are placed in the input queue (as if the terminal were 
in Local mode) . The operating system remains active until 

the terminal is reset or powered off, or until the local 
programmability SLEEP command is issued. 
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While local programmability is active, if the LED in the 

LOCAL key is on, an operator can interact directly with the 
operating system or a local program. When the LOCAL key 
light is off, the terminal reacts in the normal way to host 
communication* 



Errors 



JBOO (Level 0): Unrecognized command (Option 42/43 version 3 

or later not installed) . 

JBOO (Level 2) : 1 LPS.SYS 1 is not found on disk in drive F0: . 

JB02 (Level 3) • Out of memory while activating local 

programmability. 

JB03 (Level 2) : Context error ( local programmability already 

active) . 

JB09 (Level 2) : Disk hardware error (drive not ready , I/O 

error) . 

References 

41 TO Series CP/M-86 System Overview Manual 
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<Arm-For-Block-Mode> Command Option 1 

SETUP Mode Name: BLOCKMODE 



SYNTAX 

< arm- for- bloc k-mode> = (ESC)(0)(B) 

< int : block-mode-arming> . 



PARAMETERS 

Block-mode-arming (0 or 1). - NO; disarms the 
terminal so that it will not enter block mode. 1 = 
YES; arms the terminal to enter block mode on receiv- 
ing the next block header. 



Description 

If the <int> parameter is (1), the terminal is armed for 

block mode . It will enter block mode when it receives the 
" receive" block header specified by the most recent <set- 
block-header s> command . 

If the <int> parameter is (0), a subsequent block header 

will not put the terminal in block mode . 



NOTE 

If you do not Intend to use block mode, 
then you should not arm the terminal for 
block mode. While armed for block mode, 
the terminal cannot recognize <E0F- 
string>s coming from the host computer . 
Thus , while the terminal is armed for 
block mode, but is not yet actually in 
block mode, the only way to terminate a 
<copy> or <port-copy> is with the CANCEL 
key. 
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Before arming the terminal for block mode, the host program 
should send all necessary block mode parameter- setting com- 
mands. (These commands - except for < set-bloc k-timeout> - 
are invalid when the terminal is in block mode or is armed 
for block mode . ) 

Before arming for the terminal for block mode, you should be 
sure that the terminal T s communications input queue is large 
enough to hold an entire block. (You can use the < set-queue- 
si ze> command to make the communications queue larger. Or - 
if the host program will permit it - you can use the < set- 
block-leng th> command to make the block size smaller.) 
Also, the block mode protocol effectively suppresses any 
remote echoes which the host may be providing. Therefore, 
before placing the terminal in block mode, the host should 
issue a < set-echo> command so that the terminal will provide 
its own local echo of characters which the operator types. 



Def aul ts 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 Remembered 1 



Errors 



0B00 (Level 2): Unrecognized command. (Option 1 is not in- 
stalled . ) 

OB03 (Level 2): The communications queue size is smaller 

than the spec if ied input block si ze . 

0B11 (Level 2): Inval id "arm- for- block-mode" parameter ( must 

be or 1 ) . 
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References 

<Block> syntactic construct. 
<Set-block-continue-chars> command . 
<Set-block-end-chars> command . 
<Set- block- he aders> command . 
<Set-.block-length> command. 
<Set-blpck-li.ne-length> command . 
<Set-block-.mas.ter-qhar s> command . 
<Set-block-non-.xmt-char s> command. 
<Set-block-packing> command. 
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<Array> Parameter Types 



SYNTAX 

<arr ay> = < int- arr ay> 

or < int+-array> 
or <char-array> 
or < str ing> . 

< int-array> = <int+> [ <int> . . . 

< int+-array> = <int+> [ <int+> . 

<char-array> = <int+> [ <char> . 

<str ing> = <char-array> 



] . 

] 



Description 

The <array> parameter types allow an entire list of items to 
be sent to the terminal as one parameter . Each <array> 
starts with an integer ( passed as an <int> parameter) , 
specif ying the number of items which follow. (If this first 
< int> is zero , then no items follow. ) 

For instance , consider the <str ing> , or <array-of-char> 
parameter type . The < str ing> for the characters "FO : FILE 1 " 
is as follows : 



<string: "FQ:FILE1"> 



= <int : 8> 

(F)(0)(:)(F)(I)(L)(E)(1) 

= (8)(F)(0)(:)(F)(I)(L)(E)(1) 



Here , the first character , ( 8 ) , is the < int> parameter for 
the number eight , telling the terminal that eight <char>s 
are to follow . 

The host computer uses the < array> parameter types when 
sending command s to the terminal . However , when the terminal 
sends reports back to the host computer , a si ightly differ- 
ent format is used ; see the description of the < array- 
report parameter types . 
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Within an array , ASCII control characters are ignored . These 
are characters with decimal equivalents in the range from 
to 31. For instance, the (CR) and (LF) characters are 
ignored when encountered within an array. Thus, if you need 
to, you can break long arrays into several "lines of text," 
with ( CR ) (LF) at the end of each line. 

However, the (ESC), (US), (GS), and (FS) characters are 
exceptions . These are the characters which cause a command 
to be terminated early . ( For details , see "Commands of Three 
or More Characters , " in Section 2 . ) When the terminal 
encounters an (ESC) , ( US ) , (GS ) , or (FS) character within an 
array , it terminates both the array and the command for 
which the array is a parameter . The array count is adjusted 
to show the number of array items which were ac tually 
received before the (ESC) , (US) , (GS) , or (FS) character. 



Ref erences 

<Array-repor t> parameter types . 
<Char > parameter type . 
<Int> parameter type . 
<Real> parameter type . 
<XY> Parameter type . 
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<Array-Report> Parameter Types 



SYNTAX 

<array-repor t> = <int- arr ay-repor t> 

or <char- array- re port> 
or <str ing-report> . 

< in t- arr ay-repor t> = <int-repor t> 

[ <int-report> . . . ] . 

<char-array-report> = <int-report> 

[ <char-report> . . . ] . 

<string-report> = <char-array-repor t> • 



Description 

The terminal uses the <array-report> parameter types when 
reporting values of array parameters to the host computer . 
(This occurs in response to some of the " inquiry" commands , 
such as the <re port- terminal- setting s> command . ) 

The <array-report> syntax is similar to the <array> syntax . 
However , instead of < int> s , < int-report>s are used ; instead 
of <char>s , <char-repor t> s are used . 

If the entire will not fit within one line of text , then the 
terminal may insert one or more <EOM-indicator>s between 
individual items in the array . More prec isely , the rule is 
as follows : 

if, in send ing an array , the next item of the array ( < int- 
report> or <char-report> would cause the maximum line length 
to be exceeded , then that item is sent with a lead ing <EOM- 
indicator> as part of its syntax . For details , see the 
descriptions of < set- report- max -1 in e-length> , <EOM- 
indicator> , < int-repor t> , and <char-repor t> . 
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References 

<Array> parameter type, 
<EOM-indicator> . 
<Char~repor t> parameter type . 
<Int-report>' parameter type. 
<Set-report-max-line-leng th> command . 
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<Begin-Fill-Pattern> Command 



4112, 4113 



SYNTAX 



<begin-fill-pattern> = (ESC) (M) (D) 



< int : fill-pattern-number> 

< int : pattern-wid th> 

< int : pattern-height> 

<int : bits- per -pi xeT> . 



PARAMETERS 

Fill-Pattern-Number (1 to 32767). Number of the fill 
pattern being defined . 

Pattern-width (1 to 32). Preferred values are 1, 2, 4, 
8, 16, and 32. 

Pattern-height (0 to 480) . A height of zero deletes 
the fill pattern definition . 

Bits-per-pixel . Used to decode subsequent <raster- 
wr ite> and <runlength-wr ite> command s • In the 4112, 
val id bits-per-pixel values are 1, 2, 3, or 6. In the 
4113, valid values are 1 , 2, 3 , 4 , or 6 . 



Description 

This command begins a < fill- pat tern- defi nit ion> : 

< fill- pattern- def in it ion> = <begin-f ill- patter n> 

[ <pixel-def > . . . ] 
<end-fill-pattern> . 



<pixel-def > = <raster-wr ite> or < r un length- writ e> . 

The < fill- pattern- def initio n> defines a fill pattern for use 
when filling the interior of panels . ( For a description of 
the filling process , see the <end-panel> command . ) 



where 
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Fill Pattern Number • The first parameter in the <begin-f ill- 
pattern> command specifies the pattern number to be assigned 
to the fill pattern being created. This may be any number in 
the range from 1 to 32767. 

Width and Height • The fill pattern is a rectangular array of 
color-indices . Each number in the array names the color- 
index to which corresponding pixels will be set when an 
<end-panel> command fills a panel using this fill pattern . 

The panel height is any number from to 480 . ( Spec if ying a 
height of zero deletes the fill pattern definition . ) 

The panel width , however , should be 1 , 2, 4 , 8 , 1 6 , or 32 . 
(Other widths in the range from 1 to 32 are allowed, but may 
not produce the desired results . ) 

Figure 4-1 shows two possible fill patterns . Pattern A has a 
height and width of four pixels; pattern B has a height of 
22 pixels and a width of 16 pixels . 

In Figure 4-1 , pattern B uses color-indices from to 3 . To 
display this correctly, the panel being filled must be on a 
sur face which has at least two bit planes assigned to it . 
( See the <set-surface-definitions> command for details, ) 

(The color-indices in a fill pattern being defined are 
specified by the <raster-wr ite> and < runl eng th-wr it e> com- 
mands that come between the <begin-fill-pattern> and <end- 
f ill-pattern> commands in the < fill- pattern- definitions See 
the descriptions of the <raster-wr ite> and < runl eng th-wr it e> 
commands for details . ) 

SltS-per-pixel . The bits-per-pixel parameter is used to 
decode the < raster- write> and <runlength-wr i te> commands 
that follow. This affects which color-indices may occur in 
the fill pattern . 

If bits-per-pixel = 1 , then the only color- ind ices that may 
occur in the fill pattern are color-index and color-index 
1 . 

If bits-per-pixel = 2 , then color-indices , 1 , 2 , or 3 may 
occur in the fill pattern . 
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If bits-per-pixel = 3, then all color-indices in the range 
f rom to 7 may occur in the fill pattern . 

If bits-per-pixel = 4, then all color- ind ices in the range 
from to 15 may occur in the fill pattern . This value of 
bits-per-pixel is valid in the 4113 terminal , but not in the 

4112. 

As a convenience when writing simple host software to issue 
the < beg in- fill-pattern> command , a value of 6 is allowed 
for the bits-per-pixel parameter . If bits-per-pixel = 6 , 
then each color- index in a raster-write command occupies one 
ASCII character . In that character , the terminal uses the 
1 east- signific ant three or four bits as a color- index , and 
ignores the other bits . (The 4112 terminal uses the least- 
significant three bits , while the 4113 uses the least- 
significant four bits.) 

Thus , in the 4112 you can specify color-indices in the range 
from to 7 by sending the correspond ing ASCII characters 
( ) to (7); each color-index is represented by its corres- 
ponding decimal digit , sent as an ASCII character . In the 
4113, you can specify color-indices in the range from to 
15 by send ing the corresponding ASCII characters (0), (1), 
(9), (:), (;), (<), ( = ), (>), (?). 
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Figure 4-1 . Two Typical Fill Patterns* 



Defaults 

Parameter As Shipped On Power-Up If the Parameter 



Number, ■ From Factory . is Omitted 

1 None None Error MD11 

2 None None Error MD21 

3 None None 

4 None None 
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Errors 



MDOO (Level 0) 

MD02 (Level 3) 

MD11 (Level 2) 

MD21 (Level 2) 

MD31 (Level 2) 

MD41 (Level 2) 

Ref erences 



Unrecogni zed command 
4112 or 4113.) 



(The terminal is not a 



Not enough memory available for fill pat- 
tern . 

Invalid fill pattern number (must be in the 
range from 1 to 32767 ) . 

Invalid pattern width. ( Must be in the range 
1 t0 32. Should be 1, 2,~T~8, 16, or 32; 
other values do not necessarily give the 
desired results.) 

Invalid pattern height (must be in the range 
to 480) . 

Invalid bits-per-pixel . (In the 4112, must 
be 1, 2, 3, or 6; in the 4113, must be 1, 2, 
3, 4, or 6.) 



<End-fill-pattern> command. 
<End-panel> command . 

<Fill-pattern-definition> syntac tic construe t . 
<Select-fill-pattern> command. 
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<Btgin-Graphtext-Character> Command 



SYNTAX 




<beg in- graph text- 


character> = (ESC) (S ) (T ) 




< int : f ont> 




< int : cTiar ac ter> . 


PARAMETERS 




Font to 32767). 


Font number for character to be 


defined. 




Character (32 to 


126). Character number for character 


to be defined. 





Description 



This command starts the definition of a user-defined 
graphtex t character in the specified graphtex t font . This 
character is displayed only when all the following condi- 
tions are met : 

, The font to which the character belongs is the current 
graphtex t font . ( See the description of the <set- 
graphtex t- font> command . ) 

The current graphtex t pr ec ision is " stroke pr ec ision . " 
(See the description of the <set-graphtext-precision> 
command . ) 

The spec if ied ASCII character occur s within a < graph- 
ic- text> command ? s <str ing> parameter . ( See the de- 
scription of the <graphic- text> command . ) 

Font is the standard ASCII font . If any optional keyboard 
is installed (Options 4A, 4C , 4E , or 4F) , then fonts 1 , 3, 7 
and 9 are predefined as described in Table 4-1 . 
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When you define a character with the <begin-graphtex t- 
charac ter> and <end-graphtex t- character > commands, that 
user-defined character supercedes the pre-defined character 
of that graphtext character font . If you later delete the 
character definition with a < del et e- gr aph t ex t- character > 
command , the character is restored to its predefined mean- 
ing. 



Table 4-1 

PREDEFINED GRAPHTEXT FONTS 



Font Number 


Character Set 


Availability 





ASCII 


In all terminals 


1 


Swed ish 


With any keyboard option 


3 


U.K. 


With any keyboard option 


7 


A PL 


With any keyboard option 


9 


Dan ish/ Norwegian 


With any keyboard option 



A graphtext character definition has this syntax : 

<charac ter-def inition> = <begin-graphtex t- character > 

[< character-el em en t>. • . ] 
<end-graphtex t-charac ter> , 

where 

<character-element> = <polyline> 

or <move> 
or <draw> , 

and where 

<polyline> = < enter- vector- mod e><xy> . . . 
= (GSXxy>... • 
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The character definition implicitly includes the current 
pivot point. That is, a user-defined graphtext character has 
a pivot point which is the same as that set by the most- 
recent <set=pivot-point> command prior to the Character- 
definition)* which defined that graphtext character. When the 
character is displayed, its pivot point appears at the 
graphic beam position. 



Def aul ts 



Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 None None 

2 None None Error ST21 



Errors 



ST02 (Level 3) 

ST03 (Level 2): 

ST11 (Level 2) 

ST20 (Level 2) 

ST21 (Level 2) 



Out of memory while defining graphtext char- 
acter . 

Command is invalid at this time." (A segment, 
panel, or graphtext character is currently 
being defined.) 

Invalid font number (must be in the range 
from to 32767) . 

That character already exists in this font. 

Invalid character number (must be in the 
range from 32 to 1 26 ) . 



Ref erences 



<End-graphtext-character> command . 
<Set-graphtext-font> 
<Set-graphtext-font-grid> 
<Set-pivot-point> 
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<Begin-Higher-Segment> Command 



SYNTAX 

<beg in-higher- segments =(ESC) (S) (N) 



Description 

This command ends the definition of the segment which is 
currently being defined, and begins the definition of a 
segment with a number one greater than that of the segment 
just ended. 

The pivot point and position of the new segment are set to 
the current beam position* The current pick-id is set to 
one . 

This command is equivalent to the following sequence of 
commands : 



S0> (returns open segment number) 
(returns current beam xy ) 



<re port- terminal-settings 
<end-segment> 
<report-GIN-point : -2> 
<re port- terminal-settings: SP> (returns current pivot po int xy) 
<report- segment- stat us : -2 , X> (returns d ef aul t segment position 
<se t- pivot- po int: ( current beam xy ) > 
<begin-segment : (next higher segment ID) > 
<set-pivot- point: ( pr ev ious pivot po int xy) > 
<set- segment- posit ion : -2 , (default segment position x y ) > 

The segment definition can be terminated by an <end-segment> 
command , a <beg in- new- segment > command , a <begin-lower-seg- 
ment> command , or another <begin-higher-segment> command . 

When a segment created with this command is saved with the 
<save> command , the segment definition is saved using the 
<begin-segment> command instead of the <begin-higher-seg- 
ment> command , since al 1 segments are the same once they are 
created . 
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Er ror s 



SNOO (Level 0): Unrecognized command (the terminal firmware 

is version 1 or 2), 



SNOO (Level 2): The indicated segment already exists. 

• SN01 (Level 2): Invalid value for next higher segment number 

(current segment ID is 32767). 

SN02 (Level 3)- Out of mtmory while ending or beginning 

segment Hfinition. 

SN03 (Level 2): Context error ; command is invalid at this 

time* No segment is currently being defined, 
or a gr aphtex t character is currently being 
defined . 



Re f er ences 



< Beg in- lower- segment > command . 

<Begin-new-segment> command . 

<Begin-segment> command, 

<End-segment> command . 

<Re por t~G IN-po int> command . 

<Re por t- segment- st at us> command . 

<Report-terminal-settings> command . 

<Se t- pivot- po in t> command . 

<Se t-pick-ID> command . 

<Se t-segment-position> command . 
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< Beg in-Lower ~Segment> Command 



SYNTAX 

<beg in-lower- segments = (ESC) ( S ) ( B) 



Description 

This command ends the definition of the segment which is 
currently being defined, and begins the definition of a 
segment with a number one less than that of the segment just 
ended* 

The pivot point and position of the new segment are set to 
the current beam position. The current pick-id is set to 
one. 

This command is equivalent to the following sequence of 
commands : 

<re port-terminal-settings: S0> (returns open segment number) 
<end-segment> 

<report-G IN- point: -2> (returns current beam xy) 

<re port- terminal- set tings : SP> (returns current pivot point xy) 

<r eport-segment-status : -2, X> (returns default segment position 

<set-pivot- point: (current beam xy) > 

<begin-segment : (next lower segment ID) > 

<set-pivot-po int : (previous pivot point xy ) > 

<se t- segment- posit ion : -2, (default segment position xy)> 

The segment definition can be terminated by an <end-segment> 
command , a <beg in-hig her- segment > command , a <begin-new- 
segment> command , or another <begin-lower-segment> command • 

When a segment created with this command is saved with the 
<save> command , the segment definition is saved using the 
<beg in- segment > command instead of the <begin-lower-segment> 
command , since all segments are the same once they are 
created . 
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Er ror s 



SBOO (Level 0): Unrecognized coium^d (the terminal firmware 

is version 1 or 2 ) . 

SBOO (Level 2): The indicated segment already exists . 

SB0 1 (Level 2): Invalid value for next lower segment number 

(current segment ID is 1 ) . 

SB02 (Level 3 ) : Out of memory while end ing or beginning 

segment definition . 

SB03 (Level 2): Context error ; command is invalid at this 

time . No segment is currently being defined , 
or a graphtex t character is currently being 
defined . 



Re f er ences 



<Begin-higher-segment> command . 

< Beg in-new- segment> command . 

<Beg in-segment> command . 

<End-segment> command . 

<Report-GIN-po int> command . 

<Re por t-segmen t-status> command . 

<Report-terminal-settings> command . 

<Se t-pivot-point> command . 

<Se t-pick-I D> command . 

<Se t-segment-posi t ion> command . 
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<Begin-New-Segment> Command 



SYNTAX 






<beg in-ne w- segment > : 


z { Lolj KO ) { C ) 

<int : segment- 


number> . 


PARAMETERS 






Segfflent-nuiHbar ( 1 to 
defined . 


32767) • Number 


of segment to be 


Description 






This command begins the 


definition of a 


new graphic segment 



with the specified segment identification number . If another 
segment is open, it is closed (as with an <end-segment> 
command) . 

Valid segment numbers are 1 through 32767. If a segment with 
the specified segment number already exists, or if the 
segment number used is invalid, an error is detected and 
reported. If a graphtext character definition is currently 
open, or a panel is being defined with no segment also being 
defined, an error is detected and the command is ignored . 

The pivot point and position of the new segment are set to 
the current beam position. The pick-ID is set to one. 

Issuing this command is equivalent to issuing the following 
sequence of commands: 

<end-segment> (if segment is currently open) 

<report-GIN-point : -2> (returns current beam xy) 

<re port- terminal-settings: ( SP) > (returns current pivot point xy) 

< report- segment- status : -2 , f x'> (returns default segment position 

< set- pivot- point : ( Current beam xy) > 

<begin-segment : Segment-number> 

< set- pivot- point : ( Previous pivot point xy) > 

< set-segment- posit ion : -2 , (Default segment position xy) > 

If there is no segment currently open , issuing this command 
is equivalent to issuing the above series of commands 
without the initial <end-segment> command . 
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The segment definition can be terminated by an <end-»segment> 
command, a <begin-higher-segment> command, a <begin~lower~ 
segment> command , or another <begin-new-segment> command* 

When a segment created with this command is saved with the 
<save> command, the segment definition is sav^d using the 
<begin-segment> command instead of the <begin~new~segment> 

command, since all segments are the same once they are 
created. 



Defaults 



Parameter As Shipped On Power-Up If the Parameter 

Number From factory is Omitted 

1 None None Error SE 1 1 



Errors 



SEOO (Level 0) 

SE02 (Level 3) 

SE03 (Level 2) 

SE10 (Level 2) 

SE11 (Level 2) 

References 



Unrecognized command ( the terminal firmware 
is version 1 or 2 ) . 

Not enough memory to begin segment , or out 
of memory while defining segment . 

Command is invalid at this time ( a graphtext 
character or a panel is currently being 
defined ) . 

Segment already exists . 

Invalid segment number (must be in the range 
from 1 to 32767) . 



<Begin-higher-segment> command . 

<Begin-lower-segment> command . 
<Begin-segment> command . 

<End-segment> command • 
<Set-pick-ID> command . 

<Set-pivot-point> command . 
<Set-segment-position> command . 
<Set-segment«.image-transform> command . 



4-1 6F 



add, nov 1982 M 1 10 SERIES COMMAND REFERENCE 



ALPHABETICAL LISTING 



< Beg in-Panel-Bound ary> Command 4112, 4113 



SYNTAX 

< beg in- pan el- bound ary> = (ESC) (L ) (P) 

< xy : f ir st-point > 
<int: draw-boundary> . 



PARAMETERS 

First-point (X= to 4095, Y = to 4095). Beginning 
and end ing point for the boundary . 

Draw-boundary (0 or 1). One causes the panel boundary 
to be drawn ; zero causes the boundary to be omitted . 



Description 

This command starts the definition of a panel : a geometrical 
figure bounded by one or more straight lines . In the case of 
a panel with two or more boundaries , the <beg in-panel- 
boundary> command is also used to begin the second and 
subsequent boundaries . 

<XY> parameter . The panel boundary starts and ends at the 
point spec if ied by the <xy> parameter . 

<Int> parameter . If the <int> parameter is zero , the panel 
bound ar y is not drawn . If this parameter is one , then the 
boundary is drawn in the current 1 ine style and line index , 
as spec if ied by the most recent <set-line-style> and < set- 
line- index> command s . 

Drawing the boundary. If the panel boundary is to be drawn , 
it is drawn as the terminal receives the coord inates of the 
vertices of that boundary . Provided the terminal has first 
been pi aced in vector mode or marker mode , these coordinates 
may be sent to it as <xy> parameters . Alternatively , the 
coord inates may be sent as part of <move> , <draw> , and 
<draw-marker> command s ; these commands do not require that 
the terminal should be in vector or marker mode . 
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NOTE 

If you use <xy> parameters to specify 
boundary points, be sure that the termi- 
nal is is vector or marker mode . It must 
not be in alpha mode! If the terminal is 
in alpha mode , the <xy> parameters are 
interpreted as alphatext . If the dialog 
area is enabled, such alphatext is sent 
to the dialog area. If the dialog area 
is not enabled, such alphatext causes a 
type LP03 error and terminates the 
<panel«-def inition> . 

All parts of the boundary are drawn, regardless of any (GS) 
characters ( <enter- vector- mod e> commands) or <move> com- 
mands. No markers are drawn at the vertices of the boundary , 
regardless of any (FS) characters ( < en t er- marker- mod e> com- 
mands) or <draw-marker> commands. 

The panel boundary ends when an <end-panel> command or 
another < beg in- panel- bound ary> command occur s . The panel 
boundary is then closed , so that it ends where it began : at 
the point specified in the <begin-panel-bound ar y> command 1 s 
<xy> parameter . 

Panels with only one boundary. The simplest case is when the 
panel has only one bound ar y . In that case , the <panel- 
def ini tion> has this syntax : 

<panel-definition> = < beg in- pan el- boundary > 

[ <boundar y-point> . . . ] 
<end-panel> . 

where 

<boundary-point> = <xy> (not valid in alpha mode) 

or (GS)<xy> 
or (FS)<xy> 
or <move> 
or <draw> 

or <draw-marker> . 
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The panel boundary begins with the position given by the 
<xy> parameter in the < beg in- panel- bound ary> command; it 
continues to include the line segments defined by the <xy> 
coordinates of the < bound ar y-point> s ; and it ends where it 
began. The graphic beam position is updated to the ending 
point, which is the same as the <xy> coordinate in the 
< beg in- panel- bound ary> command. 



Figure 4-2 shows two panels , each with only one boundary . In 
the first panel , the boundary ( always a closed figure) does 
not intersect itself ; in the second , it does . 
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Figure 4-2. Two Panels, Each With Only One Boundary, 
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When the panel boundary crosses over itself (or when there 
is more than one boundary), it is not obvious what is meant 
by the "interior" of the panel. The rule for determining 
which points are "inside" the panel is this: 

• If , to get from "well outside the panel" ( that is, 
from a point infinitely far away) to the point i.n 
question, one must cross the boundary an odd number of 
times, then that point is "inside" the paneT-. (This 
rule works regardless of the route one follows to 
proceed from infinity to the point in question . ) 

# If, to get from "well outside the panel" ( that is , 
from "the point at infinity") to the point in ques- 
tion, one crosses the boundary an even number of 
times, then that point is "outside" the panel* (Note 
that "not crossing the boundary" is the same as 
"crossing the boundary zero times," and zero is an 
even number.) 



Panels with mora than one boundary* A panel can be defined 
with more than one boundary; to do this , send more than one 
< beg in- panel- bound ary> command within the <panel- 
def ini tion> . Each such command begins a panel boundary; 
< beg in- pan el- bound ary> commands after the first one also 
terminate the previous panel boundary. The full <panel- 
def ini tion> syntax then becomes: 

<panel-def ini tion> = <panel-bqunda.r y-def ini tion> 

[< panel - boundary- def in it ion> . » . ] 
<end-panel> . 



where 



< panel- boundary- def inition> 



<beg in- pan el -bound ar y> 
[< bound ary-point> . , . ] 



< bound ar y-point> 



<xy> ( 

or (GS)<xy> 
or (FS)<xy> 



(not valid in alpha mode) 



or <move> 
or <draw> 
or <draw-marker> 
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Figure 4-3 shows two panels, each with multiple boundaries. 
Note that each boundary is a closed figure. In a <panel- 
boundary-definition>, the boundary begins at the position 
specified by the <xy> parameter within the <beg in-panel- 
boundar y> command; it continues as a series of straight line 
segments determined by the < xy> coordinates of the <bound- 
ar y-point> s ; and it ends where it began. The same "odd/even" 
rule as before is used to define the panel interior. 




Figure 4-3. Two Panels, Each With Multiple Boundaries. 
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Filling the Interior. When the terminal receives the <end- 
panel> command , it fills the panel interior in the manner 
specified by the most recent < set-panel- fill ing- mod e> com- 
mand . (If the < set- panel- f i 11 ing-mode> command has specified 
that the panel is to be filled up to and includ ing the 
boundary , then any boundary just drawn is covered over when 
the panel is filled . ) 

The fill pattern used is that specified by the most recent 
< select- fill- patt ern> command . 

Text Not Allowed Within Panels. Neither alphatext nor graph- 
text is permitted within a <panel-def inition> . If the dialog 
area is enabled , any alphatext is sent to the d ialog area , 
and does not interfere with the panel being defined . How- 
ever , if the d ialog area is not enabled , alphatext causes 
the panel to be closed , as if an <end-panel> command were 
received ; a type LP03 error is detected . Gr aphtex t within a 
<panel-def inition> closes the panel and causes a type LT03 
error . 



Def aul ts 



Parameter 
Number 

1 

2 



As Shipped 
From Factory 

None 

None 



On Power-Up 

None 
None 



If the Parameter 
is Omitted 

(0,0) 





Error s 



LP00 (Level 0): Unrecognized command . (Terminal is not a 

4112 or a 4113.) 

LP03 (Level 2): Alphatext is not allowed within a <panel- 

definition> . ( When this error is detected , 
the panel being defined is closed , as if an 
<end-panel> command had been received . ) 

LP21 (Level 2): Invalid "draw border" mode ( must be or 1 ) 

References 

<End-panel> command . 

<Panel-definition> syn tac tic construct. 
< Begin- segment> command . 
<End-segment> command . 
<Select- fill- pat tern> command . 
<Set- panel- fill ing- mod e> command . 
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<iegln-Plxel-Operations> Command 4112, 4113 



SYNTAX 



<begin-pixel-operations> = (ESC) (R ) (U ) 

< int : sur face-number) 

<int : ALU-mode > 

<int : bits-per-pixel> . 



PARAMETERS 



Surfaoe-number (4112: -1 to 3; 4113: -1 to 4) • Minus 
one indicates a "super sur f ace" using all bit planes 
of all sur faces . Zero means "leave existing sur f ace 
unchanged . " Numbers greater than zero refer to specif- 
ic surfaces. 

ALU-mode (0 to 16) . Arithmetic logic unit writing 
mode . 

Bits-per-pixel . Used for decoding subsequent <raster- 
wr ite> and < runlength-wr i te> command . Zero means "no 
change . " In the 4112, valid bits-per-pixel values are 
1, 2, 3, and 6. In the 4113, valid values are 1, 2, 3, 
4, and 6 . 



Description 

This command is present in the 4112 and 4113 terminals only . 

The <begin-pixel-operations> command initial izes the termi- 
nal for subsequent <raster-wr i te> , <runlength-wri te> , <rec- 
tangle-f ill> , <pixel-copy> , arid <save> commands . These are 
the "pixel operations commands " which permit users to access 
directly the terminal 1 s raster memory buffer. 

The command has three parameters , all of parameter type 

< int> : " sur face number , " "ALU mode , " and "bits-per-pixel . " 
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Surface number* The surface number parameter specifies the 
surface on which subsequent <raster-write>, < run length- 
write^ , <rectangle-fill>, <pixel-copy> , and <save> commands 
will write (or read) their data* A value of zero indicates 
that the existing surface is not to be changed . 

A value of -1 indicates that subsequent pixel operations 
will occur on a "super surface" consisting of all the bit 
planes on all of the presently defined surfaces* This super 
surface is for advanced ' applications'. If you plan to use the 
super surface/ be sure to read Appendix D, which explains 
the super surface and its side effects, 

ALU Mode* The ALU mode (arithmetic logic unit writing mode) 
parameter is a number in the range from to 16, A value of 
zero indicates that the existing ALU mode is not to be 
changed . Values from 1 to 16 specify how <raster-wr i te> , 
< run leng'th- writ e> , and <rectangle-f ill> commands modify the 
existing contents of the terminal's raster memory buffer. 

At each pixel position in raster memory space, the color- 
index being written is regarded as a binary number and is 
combined, bit by bit, with the color-index already stored at 
that pixel location. The result is a new color-index, which 
is stored at that pixel location in the raster memory 
buf f er . 

Let A be one of the bits in the color-index currently stored 
at a particular pixel location in raster memory space. Let B 
be the corresponding bit in the color-index being supplied 
by the <raster-write> , <runlength-wr ite> , or <rec-tangle- 

fill> command. Let W be the corresponding bit of the color- 
index which the terminal's ALUs (arithmetic logic units) 
actually write into that pixel location in raster memory 
space. Then W is some function of A and B: 

W = f ( A , B ) 
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The "ALU mode" parameter selects the function f from among 
sixteen possible functions of A and B: f1(A,B) to f16(A,B). 
Table 4-2 lists the function f N selected by selected by each 
value N of the ALU mode parameter. In the table, bit A is 
the bit already stored in the raster memory buffer; bit B is 
the bit supplied by the <raster-wr ite> , <runlength-wri te> , 
or <rec tangle- f ill> command, and bit W is the resulting bit 
which is actually written into the raster memory buffer. 



Table 4-2 
ALU VALUES TABLE 



ALU mode 


W = 


f N ( A, B) 




1 


W = 


f1(A,B) - 


not A 


2 


w = 


f2(A,B) = 


not (A or B) 


3 


w = 


f3(A,B) = 


(not A) and B 


4 


w = 


f4(A,B) = 





5 


w = 


f5(A,B) = 


not (A and B) 


6 


w = 


f6(A,B) = 


not B 


7 


w = 


f7(A,B) = 


A XOR B 


8 


w = 


f8(A,B) = 


A and (not B) 


9 


w = 


f9(A,B) = 


(not A) or B 


10 


w = 


f 10(A,B) 


= not (A XOR B) 


1 1 


w = 


f 11 (A, B) 


= B 


12 


w = 


f 12(A,B) 


= A and B 


13 


w = 


f 13(A,B) 


= 1 


14 


w = 


f 14(A,B) 


= A or (not B) 


15 


w = 


f 15(A,B) 


= A or B 


16 


w = 


f 16(A,B) 


= A 
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Of the values in Table 4-2, the following are particularly 

useful: 



Mode 


W = f ( A, B) 


Use 


1 


W ■= f 1 ( A, B) = not A 


This yields a reverse video 
when used with the <rectan- 
gle-f ill> command . 


7 


W = f7(A,B) = A XOR B 


This provides an opportunity 
to write an image which can 
later be completely removed 
without trace by repeating 
the same operation . That is 
because 

A = (A XOR B) XOR B.- 

(The terminal T s firmware uses 
ALU mode 7 when displaying 
segments in "XOR mode . " See 
the description of the < set- 
segment- writing- mode> command 
for details . ) 


1 1 


W = f11(A,B) = B 


This causes a complete 
replacement of the ex isting 
image with the new pixels. 

(The terminal 1 s firmware uses 
ALU mode 11 when displaying 
segments in " set mode . " See 
the description of the < set- 
segment-wri ting-mod e> command 
for details . ) 


15 


W = f15(A,B) = A or B 


This is an "over strike mode , " 
in which the new image is 
written on top of the exist- 
ing image . Zero pixels in the 
command string do not affect 
the pixel buff er . 



If the ALU mode parameter is outside the range from to 16, 
then the 4112 detects a type RU1 1 error . 
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Bits-per-pixel • The bits-per-pixel parameter is used to 
decode subsequent <raster-write> and <runlength-wr ite> com- 
mands. (It is also used by subsequent <save> commands when 
generating a stream of <raster-wr ite> and <runlength-wr ite> 
commands to be saved on the disk drive.) See the descrip- 
tions of the <raster-wr ite> , <runlength-wr ite> , and < save- 
pixels> commands for details . 

In the 4112, "bits-per-pixel" may be 0, 1, 2, 3, or 6. In 
the 4113, valid values are 0, 1, 2, 3, 4, and 6. (A value of 
zero indicates that the existing bits-per-pixel encoding 
mode is not to be changed.) Normally, bits-per-pixel would 
be set equal to the number of bit planes used by the sur face 
being selected . (However , it may be a convenience to set 
<bits-per-pixel> to 6 ; this can simplify the host software 
used to issue <raster-wr ite> command s , since in that case 
each pixel is represented by exactly one <code> character in 
the <raster-wri te> command f s <code-arr ay> parameter . See the 
description of the <raster-wr ite> command for details . ) 

It may happen that the "surface number" parameter specifies 
a surface which has fewer bit planes than the number of bits 
specified in the "bits-per-pixel" parameter . Suppose , for 
instance , that there are M bit pi anes on the specified 
sur face , but "bits-per-pixel" = N , where N is a larger 
number than M. In that case , when subsequent <raster-wr ite> 
commands write color- ind ices into the pixel viewport , the 
color- index written is comprised of the most-signi f icant M 
bits in each N-bit color-index sent as part of the <raster- 
write> command . 



Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 1 1 Unchanged 

2 11 11 Unchanged 

3 6 6 Unchanged 
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Errors 



RUOO (Level 0): Unrecognized command. (The terminal is not a 

4112 or 4113.) 

RU10 (Level 2): Surface does not exist (has not been defined 

with a <set-sur face-def initions> command), 

RU11 (Level 2): Invalid surface number* (In the 4112, must 

be in the range from -1 to 3. In the 4113? 
must be in the range from -1 to 4 . ) 

RU21 (Level 2): Invalid ALU mode (must be in the range from 

to 16) • 

RU31 (Level 2): Invalid bits-per-pixel . (In the 4112, must 

be 0, T, 2, 3, or 6: In the 4113? must be , 
.1,2, 3, 4, or 6. ) 

Ref erences 

<Pixel-copy> command* 
<Raster-wr i te> command 
<Re'ctangle-fiil> command 
<Runlength-write> command 
<Save> command 
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<Begin-Segment> Command 



SYNTAX 




<begin-segment> = 


(ESC)(S)(0) 




< int : segment-number> . 


PARAMETERS 




Segment-number ( 1 


to 32767). Number of segment to be 


defined. 





Description 

Begins the definition of a new graphic segment with the 
specified segment identification number. 

Valid segment numbers are 1 through 32767. If a segment with 
the specified segment number already exists, or if the 
segment number used is invalid, an error will be generated 
and reported. If another segment or font definition is 
currently open, an error is generated and the command is 
ignored . 

Pivot Point . The segment will be defined with its pivot 
point at the location specified by the most recent <set- 
pivot-point> command . ( See the description of the < set- 
pivot- point> command for details . ) The pivot point is an 
unchangeable attribute of a segment ; therefore , if the 
segment T s pivot po int is to be different from that 
previously defined , it is important to issue an appropriate 
< set-pivot- point> command before issuing the <begin-segment> 
command . 
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Terminating the Segment Definition* The segment definition 
is terminated by the <end-segment> command. The segment is 
saved in RAM . Saving on the disk requires a <save> command,, 

Graphic Primitives* Within a segment definition (between the 
<begin-segment> and the < end- segment> command s) , there may 
be graphic primitives : vectors , markers , <graphic- tex t> com- 
mand s , <panel-definitions>, and sometimes alpha text • ( If 
the dialog area is not enabled , then alphatext is deemed to 
be a graphic primitive and is included in the segment being 
defined . ) 

When a segment is being defined and the dialog area is 
d isabled , the "wrap-around" features of alphatext are dis- 
abled. When the next character to be displayed would end 
past x = 4095 , it is not d ispl ayed and the alpha cursor id not 
changed . Similarly , a ( BS ) character is not processed if the 
r esul ting x-position would be less than zero . Likewise , a 
(LF) character is not processed if the resulting y-posi tion 
would be less than zero , and a ( VT ) character is not 
processed if the resulting y-coord inate would be greater 
than 3071 . 

Primitive Attributes • Also included in a segment definition 
are pr imitive attributes - commands which change attributes 
of graphic primitives . Examples of these would be < set- line- 
style> , < set- mar ker- type > , and < set- graph tex t-rotation>. 

<Include-Copy-of-Segment> Command . Besides graphic primi- 
tives , a segment definition may al so have < include- copy-of- 
segment> command s . When such a command occurs, the segment 
it references is copied into the segment being defined . (The 
segment , as transformed by its current image transform , is 
copied into the segment being defined . That is , the segment 
is after being scaled , rotated , and positioned in accordance 
with that segment T s current image transform . See the < set- 
segment- posit ion> and < set- segment- image- trans f orm> command s 
for detail s . ) 
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Syntax of <Segment-Def inition> . A segment definition would 
usually follow this syntax : 

< segment- defi nit ion> = <begin-segment> 

[ <part-of-segment> . . . ] 
<end-segment> . 

< par t- of- segment > = <move> 

or <draw> 

or <draw-marker> 

or <(GS)<xyXxy>. . .> 

or <(FSXxyXxy>. 

or < set-line-style> 

or < set-line- ind ex > 

or < se t- mar ker- type > 

or < graphic- text> 

or < set- text- ind ex > 

or < set-graphtex t- font> 

or < set-graphtex t-prec ision> 

or <set- graph text- rotation > 

or < set-graphtex t- si ze> 

or < in elude- copy- of-segment> 

or < alpha text- graph ic- prim it ive> . , 

< alpha text-graph ic- prim it ive> = any text sent to the 

the terminal with the 
terminal in alpha mode 
and with the dialog 
being disabled . 

Any printable text which is sent to the terminal while the 
terminal, is in alpha mode and the dialog area is d isabled 
will be stored in the segment . (This is the <alphatext- 
graphic-pr imiti ve> mentioned above . ) In such text , the spe- 
cial characters (HT) , ( BS) , (VT ) , (LF) , and ( CR ) are stored 
in the segment as <move>s to the appropriate <xy> positions. 
(Since these characters are stored as <move>s , they are 
scaled by any < set- segment- image- 1 ran sform> commands. In the 
4112 and 4113, they are scaled according to the current 
window-viewport transform . ) 



4110 SERIES COMMAND REFERENCE REV, DEC 1981 



4-3 1 



ALPHABETICAL LISTING 



The View In Which A Segment Is Visible. In the 41 12 and 4113 
terminals , which may have multiple views, the question 
arises, "In which view is a segment visible?" The answer is, 
that a segment is visible in the view which is selected at 
the time of the <end-segment> command that terminates the 
segment definition. (Unless, of course, a < set-segment- 
visibility> command for "segment -2 " has determined that 
newly-created segments are to be invisible.) 

If you issue a < select- view> command while a segment is 
being defined ( that is , between a <begin-segment> command 
and the following <end-segment> command ), then the segment 
is visible only in the view which is selected at the time of 
the <end-segment> command . 



Defaults 

Parameter 
Number 

1 

Errors 



As Shipped 
From Factory 

None 



On Power-Up 
None 



If the Parameter 
is Omitted 

Error S0 1 1 



5002 (Level 3) 

5003 (Level 2) 

5010 (Level 2) 

50 11 (Level 2) 

References 



Out of memory while defining segment . 

Command is inval id at this time . ( Another 
segment , a graphtex t character , or a panel 

is currently being defined*) 

Segment already exists. 

Invalid segment number ( must be in the range 
from 1 to 32767) . 



<End-segment> command . 

<Include-copy-of-segment> command . 

<Selec t- view> command . 

<Set- pivot- point> command . 

<Set-segment-posi tion> command . 

< Set- segmen t- im ag e- trans form> command 
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(BEL) Character 



Description 

Alpha Mode. When the terminal is in alpha mode, a (BEL) 
character received from the host computer causes the termi- 
nal to sound its bell. 

Marker Mode, When the terminal is in marker mode, the (BEL) 
character sounds the terminal's bell. 

Vector Mode. When the terminal is in vector mode, the (BEL) 
character sounds the bell; 

In addition, however, a (GS ) ( BEL ) sequence has a special 
effect. The (GS) puts the terminal in vector mode, since it 
comprises an <enter- vec tor-mode> command. The (BEL) immedi- 
ately following the (GS) causes a "draw" from the current 
beam position to the following <xy> coordinate. (Normally, 
the first < xy> after a (GS) causes a "move" rather than a 
"draw" to that <xy> coordinate; the (GS ) ( BEL ) sequence 
changes that.) 



Ref erences 

<Enter-alpha-mode> command . 
< En t e r- marker- mod e> command . 
<Enter- vec tor-mod e> command . 
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<Blook> Syntactic Construct (Option 01) 



SYNTAX 

<block> = [ <block- TT other-than-last"-line> . . . ] 
• < block- last- line> ... 

< block-"other~ than- last"- 1 in e> = <block-header> 

<packed-data> 
<block- continue- c ha r> 
<EOL-string> . 

< block-last- line> = <block-header> 

<packed-data> 
<block-end-char> 
<EOL-string> . 

Note . See description of block mode in the Host 
Programmer's Manual . 



PARTS OF A BLOCK 

<Block-Header> . A sequence of up to ten characters , 
set by the < set-bloc k- he ad ers> command . 

<Packed-Data> . Characters of packed data, the result 
of applying the packing algorithm selected by the 
< set-block- pa cking> command . 

<Block-Continue-Char> . An ASCII character , selected by 
the < set- bloc k- continue- char s> command . 

<Block-End-Char> • An ASCII character , selected by the 
< set- block- end -char s> command . 

<EOL-string> . A sequence of up to two characters , 
determined by the < set-EOL-str ing> command . 
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Description 

In block mode, each block sent to or from the terminal has 
the syntax described above. Each "line" of a block starts 
with a <block-header> , which is defined by the <set-block- 
header s> commando The end of each line is signalled by a 
<block-continue-char> (if it is not the last line in the 
block) , or by a <block-end-char> ( for the last line of the 
block) . 

Between the block header and the <block-continue-char> or 
<block-end-char> is a sequence of ASCII characters which 
hold the data being sent in a "packed" format ; these 
characters comprise the < block- pa cked-data>. None of these 
characters may be the same as the characters reserved as the 
<block-continue-char> and < block-end- char > . The packing 
scheme is described together with the < set- block- packing > 
command , el sewhere in this section . 

The EOM character ( usually a CR) from the keyboard , which 
terminates a terminal- to- host block , is included in the 
block as the last data character . 

The <block-header> , <block-continue-char>, <block-end-char>, 
and the block packing scheme may be different for blocks 
sent from the terminal to the host than for blocks which the 
terminal receives from the host . These parameters are set 
with the <set-block-header s> , < set-block-continue-char s> , 
< set- bloc k- end- char s> , and < set- block- packing > command s . 

For blocks sent f rom the terminal to the host computer , the 
<EOL-str ing> is the current "end of line string," set by the 
< set-EOL-str ing> command . (Typically , this is (CR) or 
(CR)(LF).) 

For blocks sent f rom the host computer to the terminal , the 
<EOL-str ing> consists of any characters which the host may 
send after the < block- continue- c ha r> or <block-end-char> and 
before the <block-header> that starts the next <block>. All 
such characters are ignored by the terminal until ( and 
unless) a printable character -- ADE 32 to 1 62 — ■ is 
encountered . When the terminal detects the printable charac- 
ter it does a carriage return and prints the detected 
character and all following text ( as unescorted text) until 
the next block header is detected . 
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Ref erences 

<Block-cont'rol--bytes> syntac tic construct , 
<Set-block-continue-chars> command. 
<Set-block-.end-ehars> command* 
<Set-block-headers> command. 
<Set-bl-ock-l"e;rigth> command, 
<Set-block-master-chars> command. 
< Set-block- no n-xmt-c ha rs> command . 
<Set-block-packing> command, 
<Set-blo : ck-timeout>; command. 
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< Block-Con trol-Bytes> Syntactic Construct 



(Option 01) 



SYNTAX 




<block-control-bytes> 


= <control-byte-1 > 




<control-byte-2> 




<control-byte-3> 




<control-byte-4> . 


Note a See description 


of block mode in the Host 


Programmer ? s Manual . 





Description 

In block mode, when the terminal or host composes a block to 
be sent over the data communications line, it appends four 
"block control bytes" to the characters or other data being 
packed into the block. 

The four control bytes are packed into the block along with 
the other unpacked data; see the description of the <set- 
block-packing> command for details . If the "unpacked byte 
size" ( as set by the < set- block- packing > command ) is seven , 
then each control byte consists of seven binary bits . If the 
unpacked byte si ze is eight , then each control byte consists 
of eight binary bits . 

< Control-By ti-1 >• Let bit 1 be the least-significant bit of 
the byte ; then bit 7 or bit 8 is the most-significant bit of 
the byte . ( Bit 7 is the most-significant bit if the "un- 
packed byte si ze" is seven , since in that case there is no 
bit 8.) The individual bits are assigned as follows : 



Bits 1 and 2: 
Bit 3, 4, 5: 
Bit 6 
Bit 7 
Bit 8 



Block count and end-protocol . 
Reserved ( always zero) 
End of file 
End of message 

Unused ( not present in 7-bit bytes ; 
always zero in 8-bit bytes) 
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In <control-byte-1>, bits 1 and 2 together serve two func- 
tions: they determine whether the terminal is to exit block 
mode, and - while the terminal is in block mode - they 
maintain an "odd/even" modulo two counter of blocks sent 
over the data communications line. Table 4-3 lists the four 
possible states of these bits , together with their meanings . 



Table 4-3 

MEANINGS OF LOW-ORDER BITS IN <C0NTR0L-BYTE-1 > 



Bit 2 


Bit 1 


Meaning 








This is an " even" block , and no 
attempt is being made to remove 
the terminal from block mode . 





1 


This is an " odd" block , and no 
attempt is being made to remove 
the terminal from block mode . 


1 





In a block sent from the host to 
the terminal , these two bits 
comprise a command to the termi- 
nal : "Ex it from block mode , but 
remain armed for block mod e . Be- 
fore exiting block mode , however , 
acknowledge this command by send- 
ing an f ACK f block to the host . " 

In a block sent from the terminal 
to the host , these two bits mean , 
"This is an ? ACK f block 
acknowledging receipt of a command 
to exit block mode . The terminal 
is now leaving block mode, but 
will remain armed for block mode . " 
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Table 4-3 (cont) 
MEANINGS OF LOW-ORDER BITS IN <CONTROL-BYTE-1 > 



Bit 2 


Bit 1 


Meaning 


1 


1 


In a block sent f rom the host to 






the terminal , these two bits 






comprise a command to the termi- 






nal : "Exit from block mode , but 






remain armed for block mode . Ex it 






block mode immediately; do not 






send an 1 ACK 1 block to the host . " 






In a block sent from the terminal 






to the host , this combination of 






bits is not allowed . 



Bit 6 , the end-of-f ile bit f is set to one at the end of a 
file transfer ; setting this bit serves the same purpose as 
the <E0F-str ing> used when the terminal is not in block 
mode . 

In blocks which the terminal sends to the host , bit 7 , the 
end-of-message bit , when set to one , ind icates that the 
terminal has terminated the block because it encountered an 
<EOM-char> or <EOM-ind ic ator> in the data being sent . When 
set to zero , this bit indicates that the block was terminat- 
ed only because the maximum block length was reached , and 
that another block follows which contains more of the same 
message . 

In blocks sent from the host to the terminal , bit 7 has a 
d if f erent meaning . If the bit is zero , the terminal is 
requested to acknowledge the block immediately ( by send ing 
an ACK block in reply) . The terminal sends the ACK block 
immediately , whether or not it has a message to pack into 
that block . (The ACK block contains only the four block 
control bytes . ) 
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If, however, the host sets bit seven to one, then the 
terminal does not acknowledge the block immediately* In- 
stead, it waits until it has a block full of data to send, 
or until it encounters an <EOM-char> or <EOM-ind ic ator> in 
the data it has to send to the host* 

When sending a block to the terminal, the host should set 
bit 7 to zero, except when it expects a response message 
from the terminal. If a response message is expected, the 
host should set bit 7 to one . 

<Control«Byte-2>« All the bits of control byte 2 are re- 
served; they are always zero* 



<Control-Byte-3> and <Control-Byte«4>. The last two control 
bytes carry a "check code" by which the receiving device 
(the terminal or the host computer) can verify that it has 
received the block with no errors. The check code is derived 
from all the unpacked data bytes which precede it : all the 
7- or 8-bit bytes of meaningful data , plus the first two 
control bytes. The process is as follows: 

1* Two "checksum bytes" - called H and L for this 

explanation - are both set equal to MaxByte . Here , 
MaxByte is 127 (for 7-bit bytes) or 255 (for- 8-bit 
bytes) . 

2, Each byte in the pr eced ing unpacked data is 

regarded as a binary numeral and added to L. The 
sum is computed as with "modulo 7 Cor modulo 8 ) 
■ end-.around-carr y ."■ That is , for . a 7-bit "unpacked 
byte size," whenever the sum exceed s the maximum 7- 
bit numeral (127), the "carry" bit is omitted and 
one is added to the least-significant bit of the 
sum. Likewise, If the unpacked byte size is .'8- bits, 
then whenever the sum exceeds 255, the carry bit is 
omitted and one is added to the least-significant 
bit of the sum » 
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This process is equivalent to the following algor- 
ithm, in which MaxByte = 127 (for 7-bit bytes) or 
255 (for 8-bit bytes) : 

BEGIN 

L : = L + Byte ; 

IF (L > MaxByte) THEN L : = L - MaxByte 

END 

3. As each byte is added to L, the new value of L is 
added to H. The same "end-around-carry" method is 
used : 

BEGIN 

H := H + L; 

IF (H > MaxByte) THEN H := H - MaxByte 

END 

4. When steps 2 and 3 have been performed for each of 
the unpacked bytes preceding the check code bytes, 
then the two check code bytes are computed as 
follows : 

BEGIN 

C1 := MaxByte - H - L; 

IF (C1 < 1) THEN C1 := C1 + MaxByte; 

ControlByte3 : = C 1 ; 

ControlByte4 : = H 

END 



Packing the Control Bytes into the Block. When all four 
control bytes have been computed, they are packed into the 
block along with any other unpacked data bytes; see the 
description of the <set-block-packing> command for details. 
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Checking a Received Block* When a block is received and 
unpacked/ the H and L checksum bytes are computed as 
described above. As each byte is unpacked, the "unpacked 
byte" is added to L (with end-around carry) , and L is added 
to H (with end-around carry) , This is done on all bytes as 
they are unpacked , includ ing all four control bytes . When 
the <block-end-char> is d etec ted , H and L should both equal 
MaxByte . That is , if the unpacked bytes are 7-bit bytes , 
then H = L - 127; if they are 8-bit bytes, H = L = 255. If 
this is not the case , then a data transmission error has 
occurred . (In that case , the terminal or the host receiving 
the block would re-transmit the last block it had sent,) 



Ref erences 

<Set- block- pa cking> command . 
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BORDER Key 4112, 4113 



Description 

This key exists only in the 4112 and the 4113. It does not 
auto-repeat . 

Pressing the BORDER key ( SHIFT-NEXTVIEW) changes the border 
attribute of the current view. If the view was formerly 
displayed without a border , then a border is drawn around 
the perimeter of its viewport . If the view already had a 
border around its viewport , then that border is removed • 



References 

<set- border- visibility> Command . 
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BREAK Key 

Description 

Pressing the BREAK key sends a "break" signal to the host • 
(In some time-sharing systems/ the "break" signal is a way 
for the terminal operator to interrupt the host computer and 
request the use of the communications line • However , many 
time-sharing systems do not recognize "breaks,") 

If the keyboard is locked, pressing BREAK also unlocks the 
keyboard. (This can also be accomplished by pressing 
CANCEL ■. ) 

For most host systems, the break signal should last for 200 
milliseconds; that is the "default" setting to which this 
parameter is set when the terminal is shipped from the 
factory . However, this duration may be changed with the 
< set- break -time> command . ( Indeed , by setting the break time 
to zero , the BREAK key can be d isabled ; this can be useful 
if the host computer does not tolerate "break" signals . ) 

Full Duplex Mode • In full duplex mode , the break signal 
consists of a "space" condition sent on the TDATA line at 
the RS-232 connector . 

Half Duplex Modes* In "half duplex normal ," "half duplex 
with automatic request to send , " and "half duplex with 
superv isor" modes , the terminal responds to BREAK by turning 
off the SRTS (Secondary Request To Send ) signal • This is a 
signal at the RS-232 interface between the terminal and its 
modem or other data communications equipment . Lf the modem 
uses the SRTS signal, then the modem turns off the secondary 
carrier. The host may or may not respond to the absence of 
secondary carrier by releasing the communications line so 
that the terminal may use it to transmit a message to the 
host . 



References 

<Set-break-time> command . 
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(BS) Character 



Description 

4114 Alpha Mode, Dialog Area Disabled. In the 4114, if the 
dialog area is not enabled (< en able- dialog- are a : 0> ) , then 
the alpha cursor marks a particular location in 4096-by-4096 
screen coordinates. In that case, a (BS) character moves the 
alpha cursor one character position to the left on the 
screen . 

If the cursor is already at the current margin, and no 
segment is currently begin defined, then (BS) moves the 
cursor to the right end of the same- line. Here, "same line" 
means "same logical line" - everything up to the ( CR ) (LF) . 
If wraparound has occurred, this may not be the same thing 
as the same "physical line" displayed on the screen. 

If the cursor is already at the current margin, and a 
segment is currently being defined, then ( BS ) has no effect. 

4112 or 4113 Alpha Mode, Dialog Area Disabled. In the 4112 
or 4113, if the dialog area is not enabled ( <enable-dialog- 
area : 0> ) , then the alpha cursor marks a par ticul ar 
location in 4096-by-4096 terminal space . In that case , a 
( BS ) character moves the alpha cursor one character position 
to the left in terminal space . Here , "one character position 
to the left" means a distance to the left in terminal space 
which correspond s to the spac ing between adjacent characters 
in the current v iewpor t in 640-by-480 raster memory space . 
If this new position in terminal space falls outside the 
current window, then the alpha cur sor is not visible . 

If the alpha cursor is already at the left edge of terminal 
space , and no segment is being defined , then (BS) moves the 
alpha cursor to the right end of the same line in terminal 
space . (That is , the al pha cursor moves to the right edge of 
terminal space , but the y-coord inate of the cursor does not 
change . ) 
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If the alpha cursor is at the left edge of terminal space , 
and a segment is currently being defined , then the ( BS ) 
character has no effect . 

4112, 4113, or 4114 Alpha Mode, Dialog Area Enabled. If the 

dialog area is enabled ( <enable-dialog--area : 1 > ) , and the 

terminal is in alpha mode, then the alpha cursor marks a 
particular location in the d ialog area scroll. In" that case , 
a (BS) character moves the cur sor one character position to 
the left in that scroll . If the cursor is already at the 
left end of that line in the d ialog area , then ( BS ) has no 
effect. 

Vector and Marker Modes • If the terminal is in vector mode 
or marker mode , then the ( BS) character has no effect . 



References 

<Enable- dialog-area command . 
<Enter-alpha-mode> command . 
< En t er- marker- mod e> command . 
<Enter- vec tor- mode > command . 



11-46 



REV, DEC 1981 4110 SERIES COMMAND REFERENCE 



ALPHABETICAL LISTING 



<Bypass-Cancel-Char> 



Description 

The <bypass-cancel-char> is a character which, when received 
by the terminal, removes the terminal from bypass mode. It 
is set by the < set- bypass- cancel- char > command. 

For more information, see the descriptions of the <enter- 
bypass-mode> and <set-bypass-cancel-char> commands. 



Ref erences 

< En t e r- bypass- mod e> command . 
<Set-bypass-cancel-char> command . 
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<Cancel> Command 



SYNTAX 

<cancel> = (ESC) (K) (C) . 



Description 

This command resets to default values a number of terminal 
parameters and modes: 

• Puts the terminal in alpha mode . ( Removes it from 
vector or marker mode . If the terminal 1 s internal 
command interpreter is parsing an escape-sequence com- 
mand , the command being parsed is terminated • ) 

$ Selects the standard alphatext font . (See <set-alpha- 
text-font> command.) 

• Removes the terminal from GIN mode ; that is, d isables 
any currently enabled GIN function . ( See <enable-GIN> 
and <disable-GIN> commands . ) 

• Unlocks the keyboard • ( See <lock-keyboard> command . ) 

• Aborts any <copy> command in progress . Any partially 
created output file is closed . (See <copy> command . ) 

• Aborts any color hardcopy in progress on a 4113 
terminal with Option 9 installed • 

• Cancels bypass mode . ( See < enter-by pas s-mode> com- 
mand . ) 

• Flushes input/output queues . (See < set-queue- size > 
command . ) Characters not sent to the host will be 
discarded and ignored . 
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• Removes the terminal from prompt mode, (See <prompt« 
mode> command . ) 

• Does not cancel a spooling operation, since this is a 
background operation and does not "listen" to a <can- 
cel> command or the keyboard* (See the <stop-spooling> 
command • ) 



Errors 

There are no errors detected for this command . 



References 
CANCEL Key 

<Disable-GIN> command . 
<Enable-4010-GIN> command . 
<Enable-GIN> command . 
<Enter-alpha~mode> command . 
<Enter-bypass-mode> command • 
<En ter-marker-mode> command . 
<En ter- vector-mod e> command . 
<Hardcopy> command . 
<Lock-keyboard> command • 
<Prompt-mode> command . 
<Set-alphatext-font> command . 
<Spool> command . 
<Stop-spooling> command . 
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CANCEL Key 



Description 

The CANCEL key (the SHIFTed version of the LOCAL key) 
performs all the functions of the <cancel> command, and 
causes an exit from snoopy mode (see the <set-snoopy> 
command description). The only way to issue a <cancel> while 
in snoopy mode is from Setup mode or by pressing the CANCEL 
key, because the terminal does not respond to "escape 
sequence 11 commands from the host while it is in snoopy mode* 

In the 4112 and 4113, pressing the CANCEL key also termi- 
nates a panel-filling operation resulting from a <page> or 
<renew-view> command ♦ 

The CANCEL key does not auto-repeat. 



References 
<Cancel> command 
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<Char> Parameter Type 



SYNTAX 

<char> = a "printing" ASCII character, that is, an ASCII 
character in the range from (SP) to ( ~ ) ; that 
is, a character with decimal equivalent in the 
range from 32 to 126. 



References 

<Char-repor t> parameter type. 
<String> parameter type. 
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<Char-Report> Parameter Type 



SYNTAX 

<char-r.epor t> = [ <eom- indicator > ] (See note • ) 

<ASCII-char> 

<ASCII^char> = (any ASCII character) . 

Note • The <eom-indicator> is rarely included in the 
<ehar-report> . The terminal only sends the <eom-indi- 
cator> if there is no other way to avoid exceeding the 
maximum line length . 



Description 

When the terminal reports the value of a <char> parameter to 
the host computer , it sends that report using the <char- 
repbrt> syntax • This consists of an optional <EOM- 
indicator> , followed by the <char> parameter being reported . 

The <char-repor t> message type is also used to report, ASCII 
character s which are not val id <char> parameters : characters 
with decimal equivalents outside the range from 32 to 126. 

For instance , during graphic input for the locator f unction 
and thumbwheel s dev ice , the <GIN-locator-re'por t> includes a 
<char-report> . That <char-report> tell s the host which key 
was pressed by the operator to initiate the <GIN-locator- 
report> . Since the operator can type any ASCII character to 
initiate a <GIN- locator- re port> , it is possible for any 
ASCII character to occur in a <char-repor t> . 
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<EOM-Indieator> . The optional <EOM-indicator> occurs in the 
<char-report> syntax because of the terminal T s "max imum line 
length" feature for messages sent to the host computer. This 
<EOM-indicator> is rarely , if ever , sent . 

The <EOM-indicator> is only sent as part of a <char-report> 
if both the following cond itions are met : 

♦ The terminal has already sent at least one character 
on the current line . (That is, it has already sent at 
least one character since the last <EOM-char> or <EOM- 
ind icator> . ) 

• If the <EOM-indicator> were not to be sent , then 
sending the <ASCII-char> character would cause the 
max imum line length to be exceeded . 

Because <char-repor t> s are always parts of larger messages 
which the terminal sends the host the second cond ition is 
seldom met . ( For usual settings of the maximum line length , 
the syntax of the larger report message will guarantee that 
the max imum line length is not exceeded . ) 

However , if the maximum line length is set too short , or if 
a "line" of the report message being sent to the host is too 
long , then it is possible that optional <E0M-ind ic ator> s in 
the syntax of the larger report would not cause the line to 
terminate soon enough . Only in that case would the optional 
<EOM-ind ic ator> in the <char- repor t> syntax come into pi ay . 

Ref erences 

<array-repor t> 
<char> 

<G IN -repor t- sequence> 
<GIN-locator-report> 
<GIN-pick-report> 
<GIN- stroke- repor t> 
<port- status- repor t> 
< segment- status- repor t> 
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CLEAR Key 



Description 



The CLEAR key (the SHIFTed version of the DIALOG key) has 
the same effect as the <cl ear-dialog- scroll> command : it 
erases the dialog area scroll . 



The clear key does not auto-repeat* 



References : 



<Clear-dialog-scroll> command . 
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<Clear-Dialog-Scroll> Command 



SYNTAX 




<cl ear- dialog- scroll> = 


(ESC)(L)(Z) . 


Description 




Erases (clears) the dialog 


area scroll buffer. 


Errors 




No errors are detected for 


this command . 


References 




CLEAR key. 
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4113 

Option 9 



sum 

<6olorhardcopy-status-report> 

s [<sig-char>] 

<char-report : (H)> 

<char-report : ( C) > 

<char-report : media-size> 

<char-report : m¥5I¥^Type > 

<char-report : copy-process> 

<char-report : nTSiT^ 

. <char-report : liragTr^^ 

.^^^ 

<int«-report : device-ID> 
<int-report : conf igur at ion-con trol> 
<int-report : X^^evTF^ 
<int-report : yi^y^ 
<int-report :. co^Hlin^^ 
<int-report : error-code> 
<EOM-indicator> 



Description 

This report is sent by the terminal in response to a 
<report-colorhardcopy-status> command . 

Media size* An ASCII character from (0) through (7) that 

indicates the size of the copy media* These sizes are : 



(0) : 


: A - 


- 8.5" 


(1) : 


: B - 


• - 11" 


X 


(2) : 


: C - 


- 17" 


X 


(3) = 


: D - 


- 22" 


X 


(4) : 


: AM 


— 297 


X 


(5) = 


= A3 


-- 420 


X 


(6) = 


: A2 


— 594 


X 


(7) : 


: A1 


— 840 


X 



1 1" 

17" ENGLISH 

22" 
34" 

210 mm 

297 mm METRIC 
420 mm 
594 mm 
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Media type. An ASCII character from (0) through (1) that 
indicates the type of media in the copier, paper or trans- 
parency. 

(0) = Paper 

(1) = Transparency 

Copy process* An ASCII character from (0) through ( 1 ) that 
indicates whether the copy process is interruptable or not. 

(0) = Not Interruptible 

(1) s Interruptible 

Device-ID. An integer that identifies the model of color 

copier. Possible values include M M69"1 ff •■ 

Conf iguration«»€ontrol* Reserved for future use, 

K»deviee«-addressability • An integer that specifies the maxi- 
mum pixels the image contains in the X direction. 

f -device-addressability* An integer that specifies the 
maximum pixels the image contains in the Y direction. 

Copies in queue • The number of copies requested from the 
copier but not yet copied. The range of this report is 
through 65535. 

Error code* A 15-bit integer. The individual bits have the 
following meanings when set to one: 

B15 B14 B13 B12 B11 BIO B9 B8 B7 B6 B5 B4 B3 B2 B1 BO 
X X X X X X X X X X D C L I J M 

X s Reserved for future use • 

D = Device error (fatal). 
C = Command error. 

L = Low on ink/toner/transfer sheets. 
I = Out of ink/toner/transfer sheets. 
J = Media jam. 
M = Out of media. 



References 

<Re port-color hardcopy-status> command . 
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<Copy> Comand 



SETUP Mode Name: COPY 



SYNTAX 

<copy> s (ESC)(J)(C) 

<string ■:■ source-* spec if ier > 

< string : separator> 

<string : JesFTnaTron^specif ier > . 

PARAMETERS 

Sourot«9peoif ier • Names the source of the -data being 

copied • Valid specifiers are the host ( ff H0 : lf ) , a disk 

file (e.g. y 11 F1 : filename" ) , an entire disk drive 

(e.g . ,"F0:") , an RS-232 peripheral port (e.g. , f, P0: fl ) , 

and the terminal display ( ff SC: !f ) . 

Separator-string* Must be the empty string or 11 TO" . 

D$stinati®fi«»ap$0if iar • Names the destination for the 
data being copied . Valid specifiers are the host ( "HO : 
") f a disk file (e.g., ft F1 : filename" ) , an entire disk 
drive ( e .g • , "FO: " ) , an RS-232 peripheral port (e.g., 
" P : " ) , and the color hardcopy interface ("HC:"). 



Description 

The <copy> command transfers data from the specified input 
device to the specified output device . For disk devices, a 

file name must also be given , unless the entire disk volume 
is being copied. 

Data are transferred as a string of 8-bit bytes ; no format 
conversion is done , nor are embedded commands executed . 

During the transfer no other processing occurs in the 
terminal; everything is queued until the copy process is 
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complete* If the copy is to the host , prior data waiting in 
the output queue is transmitted first. 

The copy operation continues until an end-of-f ile (EOF) is 
reached* The CANCEL key on the keyboard will abort the copy 
operation* If you use this key, the file is closed and the 
data written thus far is saved* 

When output is to a disk file that already exists, the old 
file on the disk is destroyed unless it is write protected . 
If the file or disk is write protected, an error occurs and 
the copy is not performed. 

If a filename is omitted from both the input and output 
specifiers, then all files on the disk volume are copied. 
Thus, a <copy> from source FO: to destination F1 : makes a 
copy of of the entire disk volume in disk drive zero onto 
the disk inserted in disk drive one* 

Filtn&^eis* Valid filenames are strings that consist of one 
through nine alphanumeric characters or periods ( . ) . 

Input and Output Specifiers* The input and output specifiers 
are <string> parameters, as follows: 



<string : ,f H0: fl > 



Specifies the host computer. 
When <copy>ing from the host 
computer , the <copy> ends when 
the current end-of-f ile se- 
quence is detected . When 
<copy>ing to the host compu- 
ter , the terminal inserts the 
current end-of-f ile sequence 
at the end of the data being 
sent to the host • ( For more 
information , see the descrip- 
tion of the <set-EOF-string> 
command . ) 



<str ing 
<str ing 
<string 



"P0:"> 
fl P1: ,f > 

"F2i n > 



Specifies one of the three RS- 
232 peripheral ports . (This 
requires that Option 10, the 
Three Port Peripheral Inter- 
face , be installed in the 
4110.) 
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<string : "FO: f ilenarne" > 
<string : " f ilename" > 



Specifies a file on the 4112 ? s 
flexible disk drive or the 
41 13's or 4114 f s first (or on- 
ly) flexible disk drive , disk 
drive number zero* 



<str ing : "F1 : f ilename"> 



Specifies a file on the 4 1 14 ? s 
second flexible disk drive , 
disk drive number one . 



<string : "F0:"> 

or 

<string : "F1 :"> 



Specifies the disk volume in- 
serted in disk drive zero or 
disk drive one. 



<string: "SC:"> 



<string: "HC:"> 
<string: "HC:0"> 
<string: "HC: 1"> 



Specifies the terminal display 
on a 4113 when Option 9 is 
installed • Valid as an input 
specifier only* 
Specifies the color hardcopy 
interface when Option 9 is in- 
stalled. Valid as an output 
specifier only . For "HC :" and 
"HC :0 ff , a black screen back- 
round copies as white . For 
"HC : 1" , a black screen back- 
ground copies as black. 



Examples* The following examples of the <copy> command show 
how it might be used to transfer data between different 
devices. 

(ESC) (J) (C)<string:"HO:"Xstring :"TO"Xstring :"P0: "> 

Transfers data coming from the host to peripheral 
Port 0. The data transfer continues until the 
current end-of-f ile string is encountered . (The 
end-of-f ile string is determined by the most re- 
cent <set-EOF-string> command . ) 

(ESC) (J) (C)<string:"F0:FILE1"Xstring:" TO"Xstring :"F1 : 

FILE2"> 

Copies the data in the file F0:FILE1 onto the file 
F1:FILE2. 
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(ESC) (J) (C)<string:"F0:FILE1"Xstring:" TO"Xstring :"H0:"> 

Transfers the contents of the file tf F0: FILE1" to 
the host computer* At the end of the data trans- 
fer, sends the host the current end-of-f ile 
str ing • 



(ESC) (J) (CXstring: " FO: "Xstr ing : "TO"Xstring: "F1:"> 

Makes a copy , on the disk volume in disk drive 
one , of the entire contents of the disk volume in 
disk drive zero . 

(ESC)(J)(C)<string: "SC :"Xstring : " TO" Xstr ing : 11 FO: FILE1 ff > 

Saves the information to create a color hardcopy 
using Option 9 on a 4113 to disk file "F0:FILE1". 

(ESC) (J)(C)<string: "FO: FILE1"Xstr ing : "TO"Xstring: "HC:"> 

Send the information to create a color hardcopy to 
the Option 9 copier interface on a 4113. 

Transfers Fron the Host* When <copy>ing data from the host 
computer , an end-of-f ile is marked with an <EOF-str ing> , 
determined by the most recent <set-EOF-str ing> command « In 
block mode , the end-of-f ile bit in the < block -con trol-bytes> 
takes the place of the <EOF-str ing> . 

However , if the terminal is in block mode , or is armed for 
block mode , it does not detect <EOF-str ing>s coming from the 
host computer . Thus , if the terminal is armed for block 
mode , but has not yet entered block mode , the only way to 
terminate a <copy> from the host computer is by pressing the 
CANCEL key. 

To avoid this condition f you should be sure not to arm the 
terminal for block mode unless you really will be using the 
block mode feature . 

Transfers To the Host* If the destination device is the host 
computer , then the terminal inserts <EOM-indicator>s into 
the data being transferred . An <EOM-indicator> is inserted 
after every N characters of data , where N is the maximum 
line length as set by the <set-report-max-line-length> com- 
mand . (This feature can be d isabled by setting the maximum 
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line length to zero.) At the end of the data, the terminal 
appends an <EOL-string> , an <EOF-str ing> , or an <EOL-string> 
sequence as set by the <set-EOF-string> and <set-EOL-str ing> 
commands* 



Transfers To Peripheral Ports* If the destination device is 
an RS-232 peripheral port ("P0: ,f , 11 P 1 : ,f , or "P2:") , the 
terminal appends that port's end-of-f ile string to the end 
of the data . (The port* s end-of-f ile string is set by the 

<set-port-EOF-str ing> command . ) 

Transfers to Color Copier* If the destination device is the 
color copier interface (Option 9 for the 4113) $ the source 
data must be in the format generated by the f, SC: ? ' device . 



Defaults 



Parameter 
Number 

1 

2 
3 



As Shipped 
From Factory 

None 

None 

None 



On Poner-Up 

None 

None 
None 



If the Parameter 
Is Omitted 

Error JC 1 1 

Error JC21 

Error JC31 



Errors 



JC01 (Level 2) : Data cannot be formatted for copier by HC: 

(Option 9 only) . 

JC03 (Level 2) : Attempt to copy an entire disk volume onto 

itself. (E.g . , a copy from FO: to FO: . ) 

JC 1 (Level 2) : Specified source device does not ex ist . 

JC 1 1 (Level 2) : Invalid source device specifier . 
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JC12 (Level 3) 

JC 1 3 (Level 2) 

JC19 (Level 2) 

JC21 (Level 2) 

JC22 (Level 3) 

JC30 (Level 2) 

JC31 (Level 2) 

JC32 (Level 3) 

JC33 (Level 2) 

JC39 (Level 2) 



Parameter 1 memory error ( out of memory 
while parsing the first parameter , or while 
executing the command ) • 

Parameter 1 context error (not an input 
dev ice , or dev ice is busy) . 

Disk hardware error or drive not ready on 
the source disk drive . 

Invalid separator string (must be empty 
string or "TO") . 

Parameter 2 memory error . (Out of memory 
while parsing the separator string . ) 

Specified destination device does not exist, 

Invalid destination specifier . 

Parameter 3 memory error . (Out of memory 
while parsing the third parameter , or while 
executing the command . ) 

Parameter 3 context error (not an output 
dev ice , device is busy , or ex isting disk 
file is protected ) . 

Disk hardware wr ite protected or drive not 
ready on the destination disk drive • 



References 

< Ar m~ f o r- block -mod e> command . 
<EOF-str ing> syntactic construct . 
<EOM-indicator> syntactic construct . 
<Format> command . 
<Set-EOF-str ing> command . 
<Set-EOL~str ing> command . 
<Set-port-EOF-str ing> command . 
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(CR) Character 



Description 

The effect of receiving a (CR) character from the host 
depends on whether the dialog area is enabled, (For more 
information on enabling and disabling the dialog area , see 
the description of the < en able- dialog- area> command,) 

If the Dialog Area is Disabled. If the terminal is not in 
alpha mode, receiving a (CR) character puts it in alpha 
mode. If the terminal has been enabled for 401 0-style 
graphic input (< en able- 4010 -GIN> command ), it is d isabled 
from graphic input mode. (The effect of the <enable-401 0- 
GIN> command is cancelled . ) The current line style is reset 
to line style 1 (solid line). 

A "carriage return" action is then performed. In the 4114, 
the alpha cursor moves left to the current margin. (If 
margin 1 is in effect, this is the line y=0 in terminal 
space coord inates . ) In the 4112 and 4113, the alpha cursor 
moves to the left edge of terminal space ( the line y=0 ) ; if 
this po int is outside the current window, then the alpha 
cur sor will not be visible. 

If "CR-implies-LF" mode is in effect ( see <crlf> command) , 
then a "line feed" action is al so per formed , as if the 
terminal had received a (LF) character . 

If the Dialog Area is Enabled • If the terminal is not in 
alpha mode , then the ( CR ) character has no effect . 

If the terminal is in alpha mode , then the alpha cursor in 
the d ialog scroll is moved to the left end of the current 
line of that scroll . Moreover , is " CR-impl ies-LF" mode is in 
effect , then a "line feed" action is al so per formed ; this 
advances the alpha cursor to the start of the next line in 
the d ialog scroll . 



Ref er ences 

<CRLF> command . 
<Enable-dialog-area> command . 
< Enter- alpha- mod e> command . 
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<CRLF> Command 



SETUP Mode Name: CRLF 



SYNTAX 

<crlf> = (ESC) (KMRXint: CRLF-mode > . 
PARAMETERS 

CRLF-mode (0 or 1). 1 = YES; "(CR) implies (LF) ." = 
NO; the "CRLF" feature is turned off. 



Description 

I f YES (mode 1 ) is specified , then the "carriage return 
implies line feed" feature is enabled . When a (CR) is 
received from the host , or is typed in LOCAL mode or with 
local echo turned on, the terminal displays it as if a 
(CRMLF) had been received. If the RETURN key on the 
keyboard is pressed , the generated (LF) is not sent to the 
host . 

If NO (mode ) is specified , the "carriage return impl ies 
line feed" feature is disabled . 



Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 Remembered 
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Errors 



KR11 (Level 2): Invalid "CR-impl ies-LF" mode (must be or 

1). 

Ref erenees 



<LFCR> command. 
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<Def ine-Maero> Command 



SETUP Mode Name: DEFINE 



Syntax 



SYNTAX 

<def ine-macro> =(ESC) (K) (D) 

<int : macro-number) 
<int-array : macro-contents> . 

PARAMETERS 

Macro-Number (-32768 through -32742, -32740 through 
-32737, -32608 through -32513, and -1 through 32767). 

The number of the macro being defined . Macro numbers 
-32768 through -32742, -32740 through -32737, and 
-32608 through -3251 3 specify "byte-macros" , macro 
numbers through 143 specify "key-macros" , macro 
numbers 144 through 32767 specify "host-macros" , and a 
macro number of - 1 means "delete al 1 macros" . 

Macro-Contents (0 to 127) • An <int-array> with to 
65535 elements , with element values through 1 27. 
This parameter defines the characters ( using their 
ASCII decimal equivalents) that result when the macro 
is expanded • An array of zero length deletes a macro 
definition for the specified macro number . 



Description 

The <def ine-macro> command defines or deletes a macro ( or 
all macros) . There are three types of macros : byte-macros , 
key-macros , and host-macros . There is no difference in the 
way that these three macro types are defined or stored , only 
in the ways they are expanded • 
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If the macro-number is - 1 , all macros are deleted, regard- 
less of the macro-contents parameter. To delete a single 
macro , specify the macro-number and define the macro-con- 
tents as a zero length array . For macros to 143* deleting 
the macro definition causes the corresponding key on the 
keyboard to revert to its "unpr ogrammed" meaning* 

It is possible to save macro definitions specified by this 
command with the <save> command* See the description of the, 
<save> command for details . 

The macro-contents may include any combination of ASCII 
characters , including any 4110 command. Nesting of macros is 
permitted , so that one macro may expand another . 



Macro Types 

Byte-macros • Byte-macros have macro-numbers in the ranges 
-32768 through -32742, -32740 through -32737, and -32608 
through -325 13. These values correspond to the 8-bit ASCII 
character which is reached by adding 32768 to the macro- 
number . The ASCII characters that correspond to these macro 
numbers have the ASCII decimal equivalents through- 26, 28 
through 30, and 1 60 through 255. For example , macro-number 
-32768 corresponds to (NUL) , and -32737 corresponds to (US) . 
The gaps in the range provided for byte-macros are to 
prevent sensitive characters ( such as (ESC) and the pr inta- 
ble ASCII characters) from being redefined . 

To access the byte-macros correspond ing to the 8-Jit ASCII 
values 160 through 255 (macro-numbers -326Q8 through 
-325 13) , you must use either 8-bit packing in block mode , or 
data parity with control over the eighth bit so that you can 
send the corresponding characters to the terminal command 
processor . 

Key-macros. Key-macros have macro-numbers in the range 
through 143. Macro-numbers through 127 correspond with the 
ASCII characters (0 through 127) as they are typed on the 
keyboard. Macro-numbers 128 through 143 correspond to the 
terminals function keys : 128 through 135 map onto F1 
through F8 (the un-shifted function keys) , and 1 36 through 
143 map onto 51 through S8 (the shifted function keys) . 

H08t-»maoros» Host-macros have macro-numbers in the range 144 
through 32767. There is no correspondence between host- 
macros and the ASCII character set or terminal keyboard . 



rev, nov 1982 4110 SERIES COMMAND REFERENCE 



ALPHABETICAL LISTING 



Expanding Macros 

Byte«ft&cro8« Byte-macros are expanded when the 8-bit ASCII 
character that corresponds to the byte-macro's macro-number 
is received by the terminal's command processor* The 
character may come from the host, from the keyboard when the 
terminal is in ECHO YES or LOCAL Mode, or from the data 
stream that results from a <load> command . Characters typed 
in SETUP Mode are not expanded as byte-macros. 

Any character within the byte-macro* s macro-contents which 
corresponds to a byte-macro is also expanded ( because that 
character is received by the command processor) . Any <ex- 
pand-macro> command in the macro-contents expands the appro- 
pr iate key- or host-macro , includ ing any byte-macr js that 
are part of the key- or host-macro expansion . 

As a byte-macro is expanded , the character to which it 
corresponds is unmapped from the macro-contents for as long 
as it takes to complete the expansion . This prevents the 
occurence of an infinite loop. Once the macro is fully 
expanded , the character is remapped onto the macro-contents . 

If macros are nested , each byte-macro is unmapped and 
remapped each time its expansion is begun and f inished , so 
that there may be more than one expansion of a byte-macro 
within another macro so long as that individual byte-macro 
is not nested within itself . 

Key-macros. Key-macros can be expanded with the <expand- 
macro) command or by pressing the key (or combination of 
keys) on the terminal keyboard to which the macro corre- 
sponds . 

When a key-macro is expanded with an <expand-macro> command 
received from the host ,or from the keyboard when the 
terminal is in ECHO YES or LOCAL mode , any <expand-macro> 
commands or byte-macros in its contents are expanded as if 
they came from the host . 

When a key-macro is expanded by its corresponding keys- 
troke^) , and SETUP mode is disabled , the macro-contents are 
sent to the host communication port as if the they **ad been 
entered at the keyboard . If LOCAL mode or local echo are 
enabled , the contents are sent to the command processor , so 
that any <expand-macro> commands or byte-macros in the 
contents are treated as if they had come from the host . 

When a key-macro is expanded while SETUP mode is enabled 
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(either with keystroke(s) or with the <expand-macro> com- 
mand), all characters within the macro-contents are treated 
as if they had been typed into the keyboard with "SETUP mode 
enabled, including <expand-macro> and other terminal com- 
mands . 

You may use the <key-execute-character> within a key-macro's 
macro-contents to toggle the flow of the macro-contents -,back 
and forth between the terminal's command processor and the 
host communication port* This method only works if the key- 
macro was expanded by a keystroke and the terminal is not in 
SETUP mode. 

With thumbwheel GIN enabled, pressing a key with a macro 
defined for it will cause a GIN event for each character in 
the macro which would normally be sent to the host • 

Host-macros, Host-macros are expanded with the <expand- 
macro> command • This command may be issued from the host 
computer or from the keyboard while the terminal is in SETUP 
or LOCAL mode • 

If the <ex pand-macro> command is received from the host or 
while the terminal is in LOCAL mode , any byte-macros within 
the macro-contents are expanded ( unless they have already 
been expanded), as are any <expand-macro> commands* 

If the <expand-macro> command is entered when the terminal 
is in SETUP mode , the contents of the specified macro are 
treated as if they had been typed on the keyboard while the 
terminal was in SETUP mode • 



Defaults 

Parameter As Shipped On Po**er-Up If the Parameter 

Number From Factory is Omitted 

1 None None 

2 None None Empty array 
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Errors 



KD11 (Level 2) 

KD21 (Level 2) 

KD22 (Level 3) 

References 



Invalid macro number (must be in range 
-32768 through -32742, -32740 through 
-32737, -32608 through -32513, or -1 through 
32767)* 

Invalid <int-array> (length must be from 
through 65535, <int> values must be in range 
from through 127) . 

Insufficient memory to define macro . 



<Expand-macro> command . 
<Key-execute-character> 
<Save> command . 



4110 SERIES COMMAND REFERENCE add,novi982 



4-.68A 



ALPHABETICAL LISTING 



( 



c 

4-68B add, nov 1982 41 10 SERIES COMMAND REFERENCE 



ALPHABETICAL LISTING 



(DEL) or (RUB OUT) Character 



Description 

The (DEL) or (RUB OUT) character is one of the ASCII control 
characters. This character has no special effect on the 
terminal. If the terminal is in snoopy mode, (DEL) is 
displayed as a miniature two-letter abbreviation. If the 
terminal is not in snoopy mode, but is in alpha mode, (DEL) 
has no effect on the terminal. 

The (DEL) character, however, may occur as a <LoY> or 
<Ex tr a> byte in an <xy> parameter, or as a <HiI> byte in an 
< int> or < int+> parameter. (See the descriptions of the 
<int> and <xy> parameters for details.) This can present a 
problem, especially if a host computer also uses (DEL) as a 
"filler" character. Such a host may intersperse (DEL ) s as 
" fillers" in the stream of characters it sends to the 
terminal; and these filler characters could be mis-inter- 
preted by the terminal as meaningful data. 

Two terminal features are provided to overcome this diffi- 
culty. Firstly , the < ignore-DEL> command lets you specif y 
that the terminal is to ignore any ( DEL ) s which the host may 
send as filler characters . Second ly , within <xy> and <int> 
( or < int+> ) parameter s , the terminal interprets the <delete- 
equivalent> string , (ESC) (?) , as if it were the (DEL) 
character. 



References 

<Delete-equivalent> syntactic construct . 
<Ignore-DEL> command . 
<Int> parameter type . 
<XY> parameter type . 
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<D«let«-Equivalent> Syntactic Construct 



SYNTAX 




<delete-equivalent> = 


: (ESC)(?) . 



Description 

The <delete- equivalents string , (ESC) (?) , may be used in 
place of the (DEL) character when sending < int> , < int+> , or 
< xy> parameters to the terminal. (This .. feature, together 
with the < ignore— DEL> command , lets you cope with host 
computers which intersperse (DEL) filler characters among 
the characters they send to the terminal . ) 

When the terminal receives (ESC) (?) as part of an < int> , 
< int+> , or < xy> parameter , it interprets the (ESC) (?) se- 
quence as if it were the the ( DEL ) character . 



Ref erences 

(DEL ) character . 

< I n t > and < int+> parameter types . 
<Xy> parameter type . 
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<Delit0-File> Command (Options 42 and 43) 



SETUP Mode Name: DELETE 



SYNTAX 

<delete-file> = (ESC)(J)(K) 

<str ing : file-specif ier > . 

PARAMETERS 

File-specifier . Specifies the file to be deleted . 
Takes the form "Fn : filename , " where ri is the disk 
drive number ( or 1) and filename consists of up to 9 
letters , d igits , or periods (full stops). 



Description 

Deletes the specified file from the disk structure . 
Example 

To delete the file ABCDEF from the first disk drive zero 
( "FO : " ) , issue the following <delete-f ile> command : 

<delete-file : "FO : ABCDEF"> 

= (ESC) ( J) (KXstring : "FO : ABCDEF"> 

= (ESC)UHK) (9)(F)(0)( :)(A)(B)(C)(D)(E)(F) . 
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Defaults 

Parameter 

Number 

1 

Errors 



As Shipped 
From Factory 

None 



On Power-Up 

None 



If the Parameter 
is Omitted 

Error JK11 



JKOO (Level 2) 

JK10 (Level 2) 

JK11 (Level 2) 
JK12 (Level 3) 

JK13 (Level 2) 

JK19 (Level 2) 

References 



Unrecognized command . (Disk drive option is 
not installed . ) 

The specified file or disk drive does not 
exist . 

Invalid device specifier* 

Parameter 1 memory error • ( Out of memory 
while parsing parameter 1 . ) 

The specified device ( a) is not a disk 
drive, (b)is wr it e- protected , or ( c) detects 
a bit map error . 

Disk hardware error . (I/O error , drive not 

ready, or hardware wr ite-protect error.) 



None , 
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<Delete-Graphtext-Character> Command 



SYNTAX 

<delete-graphtext-character> = (ESC) (S) (Z) 

<int : f ont-number> 
<int : cTiar-number> • 

PARAMETERS 

Font-Number (-1 to 32767) . Minus one means "all 
fonts • " Numbers from to 32767 refer to specific 
fonts . 

Char-Number (-1 , or 32 to 126) . The numeric equivalent 
of a character within the specified font . 



Description 

The named character of the specified user-defined graphtext 
f ont is deleted . Using a number of " - 1 " deletes all items of 
that nature , as follows : 

f ont number = -1 : deletes the specified user- 

defined character in all 
fonts . 

character number = -1 : deletes all user-defined char- 
acters in the specified font . 

If the specified character number does not exist in the 
specified font , a type SZ20 error is detected . 

When a user-defined graphtext character is deleted , it is 
superceded by the corresponding predefined character for 
that font . For most fonts , that is the same as the corre- 
sponding character in the standard ASCII font ( font 0). 
However , if a keyboard option is installed , and the font is 
f ont 1, 3, 7, or 9, then this is the corresponding character 
of the U.K., Swedish , APL , or Danish/Norwegian font . See the 
description of the <begin-graphtext-character> command for 
details . 
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c 

Specifying a character number of -1 not only deletes all the 
characters in the specified font, but also deletes the 
graphtext font grid for that font . See the description of 
the <set-graphtext-font-gr id> command for details. 



Defaults 



Parameter 

Number 

1 

2 

Errors 



As Shipped 
From Faotory 

None 

None 



On Power-Up 

None 
None 



If the Parameter 
Is Omitted 



Error SZ21 



SZ03 (Level 2): Command is invalid at this time. ( A graph- 
text character is currently being defined . ) 

SZ 10 (Level 1): The specified font does not exist (no char- 
acters have been defined for that font) . 

SZ 1 1 (Level 2) : Invalid font number (must be in the range 

from -1 to 32767)- 

SZ20 (Level 1): The character specified does not exist in 

this font . 

SZ21 (Level 2) : Invalid character number . (Must be -1 , or in 

the range from 32 to 126.) 

Ref erences 
None . 
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<Delete-Segment> Command 



SYNTAX 

<delete-segment> = (ESC)(S)(K) 

<int : segment- number > . 

PARAMETERS 

Segment-Number (-3, -1 , or 1 to 32767). The number of 
the segment to be deleted. Minus three means "all 
segments in the current matching class . ,f Minus one 
means "all segments . " 



Description 

The specified segment is removed from memory • On a 4114, if 
the segment is currently visible on the screen and displayed 
in refresh mode , it is removed from the display . If the 
segment is currently being defined , the segment definition 
is terminated , and then the segment is deleted . 

On a 4112 or 4113, the display is updated to the extent 
specified by the most recent <set-fixuplevel> command . 

If the <int> parameter is -1 , all segments are deleted . 
(This does not include segment 0, the cross-hair cursor , 
which cannot be deleted . ) 

If the <int> parameter is -3 , then all segments in the 
current segment matching class are deleted . ( The "current 
segment matching class is defined as the intersection of 
certain segment classes and the complements of other segment 
classes . See the description of the < set- cur rent-mat ching- 
class> command for details . ) 

Segments , unlike disk files , cannot be protected against 
deletion . Before issuing the <delete-segment> command , care 
should be taken that the command is really needed and that 
the segment number reported for deletion is correctly given . 
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In the 4112 and 4113, if all segments and all views are to 
be deleted, it is faster to delete views first, and then 
delete segments • 



Defaults 

Parameter 

Number 

Errors 



As Shipped 
From Faotory 

None 



On Power-Up 

None 



If the Parameter 
is Omitted 

Error SK11 



SK02 (Level 3): Out of memory while attempting to delete a 

segment . 

SK10 (Level 1): Segment does not exist . 

SK1 1 (Level 2 ) : Invalid segment number (must be -3> ; —1i or 

in the range from 1 to 32767 ) . 

Ref erences 

<Begin«-segment> command. 
<End-segment> command . 
<Set-f ixup-level> command . 
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<Dtlete-View> Command 4112, 4113 



SYNTAX 






<delete-view> = 


(ESO(R)CK) 

<int: view-number> . 




PARAMETERS 






View-Number (-1 

Minus one means 
view. 11 


t© 64) . Names the view to be 
"all views." Zero means "the 


deleted . 
current 



Description 

The designated view is deleted . If <int> = , the current 
view is deleted . If <int> = -1 , all views are deleted . 

If the current view is deleted , the next sequential view 
becomes the current view. If there are no other views (e.g. , 
after < int> = -1 ) , then view one ( the default view) is 
selected and initialized . 

If all segments and all views are to be deleted , it is 
f aster to delete views first , and then delete segments . 



Defaults 

Parameter Ai Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 None None 
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Errors 

RKOO (Level 0): Unrecognized command. (The terminal is not a 

41 12 or a 41 13. ) 

RK10 (Level 2): The desgnated view does not exist (has not 

been defined with a <select-view> command) . 

RK11 (Level 2): Invalid view number (must be in the range 

from -1 to 64) . 

References 

<Select~view> command . 
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<Deviee-Status~Report> Message Type 



SYNTAX 



<device-status-report> s [<sig-char> 3 

<dev ice-spec if ier> 
<int-report : status-word> 
<EOM-indicator> • 



<dev ice- specifier^ s <char-report><char-report> • 
PARTS OF THE REPORT MESSAGE 

<3ig-Char>. The signature character for non-GIN re- 
ports , as set by the most recent <set-report-sig- 
chars> command . If this character is (NUL) , it is 

omitted • 



<D«vic*-specif ler> . Two <char-report>s specifying the 
device whose status is being reported : 



(SPXSP) 

(H)(0) 

(F)(0) 

(F)(1) 
(P)(0) 
(P)(1) 
(P)(2) 
(H)(C) 



Invalid device. 
Host communication port 
Disk drive number zero . 
Disk drive number one . 
RS-232 peripheral port zero, 
RS-232 peripheral port one . 
RS-232 peripheral port two . 
Color hardcopy interface . 



Status-Word* A number whose binary bits hold status 
information , see Tables 4-4, 4-5, and 4-5a. 

<E0M-Ind icator> • See separate article on the <E0M- 
indicator> . 
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Description 

The <dev ice-status-report> is sent by the terminal to the 
host computer in response to a <report-device-status> com- 
mand. 

When the terminal sends a report to the host bypass mode is 
entered. (See <enter-bypass-mode> . ) 

<Slg-char> • The first item in the report is the signature 
character, as set by the most recent <set-report-sig-chars> 
command . If this character is ( NUL) , then it is omitted from 

the report* 

The signature character is a useful portion of the report . 
If a status report is being invoked by the host while a GIN 
device is enabled , the signature character enables the host 
to distinguish the <dev ice-status-rep^rt> from any GIN re- 
ports . which the terminal may also be sending to the host . 
For details , see the <set-report-sig-chars> command . 

Device Mnemonic, The second item is a two-character device 
mnemonic , sent as two <char-report>s . The codes which may 
occur here are : 

(SP) (SP) Sent if the <report-device-status> command 

specified an invalid device-specifier parame- 
ter. 



(H) 


(0) 


Host communication port . 




(F) 


(0) 


Disk drive number zero . 




(F) 


(1) 


Disk drive number one . 




(P) 


(0) 


RS-232 peripheral port number 


zero . 


(P) 


(1) 


RS-232 peripheral port number 


one . 


(PI 


>(2) 


RS-232 peripheral port number 


two . 


(h: 


KC) 


Color hardcopy interface . 
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<XBt*R«port>* The <int-report> contains an integer in the 
range from to 32767* When the integer is represented as a 
15-bit binary numeral, some of its bits hold status informa- 
tion about the device named in the device mnemonic. 

The <int~report> for the host communication port is always 
one. If the <report~device~status> command had an invalid 
device-specifier string, then this <i*»*-report> parameter is 
zero. 

Table 4-4 lists the meanings of the bits in the status 
integer for a disk drive. 



Table %-4 

STATUS INTEGER FOR DISK DRIVE (MNEMONIC »F0" OR ■F1*> 



B15 


B14 


B13 


B12 


B1 1 


B10 


B9 


B9 


B7 


B6 


B5 


B* 


B3 


B2 


B1 


BO 


X 


X 


X 


X 


X 


X 


X 


X 


X 


W 


R 


X 


D 


X 


B 


P 



The meanings of the bits (when set to 1 rather than 0) 
are as follows : 



X Reserved for future use. 

W The disk drive write protect switch was on when the 
the disk drive door was last closed . 

R The disk drive is ready . That is, a disk volume is 
installed and the door is closed . 

D A double-sided diskette is installed • 

B The disk drive is busy ( performing a read or write 
operation) . 

P This disk drive is installed in the terminal . 
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Table 4-5 lists the meanings of the bits in the status 
integer for an RS-232 peripheral port. 



Table 1-5 

STATUS INTEGER FOB RS-232 PERIPHERAL PORT (PO, P1, OR P2) 



B15 


B14 


B13 


B12 


B1 1 


B10 


B9 


B8 


B7 


B6 


B5 


B4 


B3 


B2 


B1 


BO 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


B 


P 



The meanings of these bits (when set to 1 rather than 0) 
are as follows : 



X Reserved for future use • 
B Peripheral port is busy. 

P This peripheral port is installed in the terminal . 
(This does not necessarily mean that there is a peripher- 
al dev ice attached to the the peripheral port.) 
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Table 4-5a lists the meaning of bits in the status integer 
for the color hardcopy interface. 



Table 4-5a 

STATUS INTEGER FOR COLOR HARDCOPY INTERFACE ("HC") 



B15 


B 1 M 


B13 


B12 


B1 1 


B10 


B9 


B8 


B7 


B6 


B5 


BH 


B3 


B2 


B1 


BO 


X 


X 


X 


X 


X 


X 


X 


X 


I 


A 


X 


X 


X 


C 


F 


B 



The meanings of these bits (when set to 1 rather than 0) 
are as follows : 



X Reserved for future use . 

I The image is produced parallel with the long axis of 
the media ( as opposed to with the short ax is) . 

A The copier has acknowledged a data transfer . 

C The copier is connected and powered-up. 

F A copier fault condition ex ists . 

B The copier is busy . 



<E0M-Indlcator> . The <EOM-indicator> serves to terminate the 
report . If the terminal is not in block mode , this is just 
the current <EOL-string> , as set by the most recent <set- 
E0L-string> command . Typically , it is a ( CR) character . If 
the terminal is in block mode , the <EOM-indicator> is sent 
by ending the block and setting the block's end-of-message 
bit ♦ See the <EOM-indicator> and <b lock-control-byte s> 
descriptions for details . 
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References 

<Char-report> syntactic construct* 
<Eom~indicator> syntactic construct ♦ 
<In t-report> syntactic construct* 
<Report-dev ice-status> command . 
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DIALOG Key 



Description 

The DIALOG key has a similar effect to the <set-dialog-area- 
visibil ity> command. Pressing the key the first time turns 
on the light in the key and causes the terminal to execute a 
< set -dialog- are a- visibility : 1 > command , making the dialog 
area visible. Pressing the key again turns off the light in 
the key and causes the terminal to execute a < set-dialog- 
area-visibility : 0> command, making the dialog area invisi- 
ble. 

This key does not auto-repeat. 
References 

<Enable-dialog-area> command. 
<Set-dialog-area-visibility> command . 
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<Blrtotor y> Command 



(Options 42 and 43) 



SETUP Mode Name: DIRECTORY 



SYNTAX 



<directory> 



(ESC)(J)(D) 

<str ing : in put- device- spec if ier > 
<str ing : se.parator-str ing > 
<str ing : H¥stTnat"i6h-3pecif ier > 



PARAMETERS 

Xnput-Device-Speeifier ( f, F0: ff or ff F1 : ff ) . Specifies the 
disk drive for which a directory is desired. 

Separator-String (Empty String or f, T0 ff ) . 

Destination-Specifier . Specifies the device to which 
the directory information is to be sent . Possible 
destinations are the host computer "HO: !T , an RS-232 
peripheral port ("PO:" , "P1 :" , !f P2: ff ) , a disk file 
(e.g. , "FO : DIRECTORY" ) , or the terminal's display 
(specified with the empty string) . 



Description 

The <directory> command lists directory information for the 
specified device , sending that information to the specified 
output device . 

This command may also be typed from the keyboard in setup 
mode . 
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Example . To make the terminal send the host a directory of 
the files on Disk Drive 1, the host can send the following 
command : 

<directory : "F1:", "TO", "H0:"> 

= (ESC) ( J) (D)<string:"F1 : "Xstr ing : "TO"Xstr ing : "HO: "> 
= (ESC)(J)(D')(3)(F)(1)(:)(2)(T)(0)(3)(H)(0)(:) . 



Report Format, The directory is sent to the destination 
device as if it were being copied from a file. If the 
destination device is the host , the end of the report is 
signalled with an <EOF-str ing> , or ( in block mode) by 
setting the "end-of-f ile" bit in the <block-control-bytes> . 
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i 

Figure 4-4 shows a typical directory report. 



-NAME BLOCKS BYTES PROTECT 



F0 : K7KK 


2002 




NO 


KITTY 


9 


6 


NO 


DSTAR 


46 


56 


NO 


BUMP 


34 


84 


NO 


'DRAGON 


15 


1 07 


NO 


GRINCW 


9 


154 


NO 


0SU1 


~~ 

( 


22 


NO 


LA'-iEPGilN 




1 09 


NO 


MAZE 


6 


162 


NO 


MAGIC 


5 


18 


NO 


MICKEY 


4 


121 


NO 


PARAB 


4 


147 


NO 


R2D2 


TO 
1_ (J 


1 03 


NO 


SNOOPY 


■ — 1 
i_ 


205 


NO 


STAR 


5 


213 


NO 


SYMBOL 


10 


104 


NO 


UIZARD 


9 


75 


NO 


SEGMENT! 


10 


153 


NO 


PATTERNS 


4 


206 


NO 


PATTEP.NS2 


10 


■—i ' — i 

C l 


NO 


-ENTRIES USED: 


19 






-ENTRIES FREE: 


349 






-BLOCKS USED : 


271 






-BLOCKS FREE: 


1731 






-LARGEST FREE: 


1715 







3892-4 

Figure 4-4. <Directory> Command Report Format. 
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Seta Transfers To The Host. If the destination device in the 
<directory> command is the host computer, then the terminal 
inserts <EOM-indicator>s into the data being transferred. 
(See the <set-report-max-line-length> command for details . ) 
Since the data in a <directory> report is already broken up 
into lines of text with (CR) characters, these additional 
<EOM-indicator> s are usually not desired. They can be sup- 
pressed by setting the maximum line length to zero. 

Also, the terminal appends the current <EOF-str ing> to the 
end of the data being sent to the host. 

Seta Transfers To A Peripheral Port, if the destination 
device is an RS-232 peripheral port ( "PO:" , "PI:", or "P2: 
"), the terminal appends that port's end-of-f ile string to 
the end of the data being transferred . (This is not done if 
a "plotter" device protocol such as "4662" or "4663" been 
<port-assign>ed to that peripheral port . ) 



Defaults 



Parameter 

Number 

1 

2 
3 



As Shipped 
From Factory 

None 

None 

None 



On Power-Up 

None 
None 
None 



If the Parameter 
is Omitted 

Error JD11 

Error JD21 

Error JD31 
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Errors 



JDOO (Level 2): 

JD10 (Level 2): 

JD11 (Level 2): 

JD12 (Level 3) : 

JD13 (Level 2): 

JD19 (Level 2): 

JD21 (Level 2) : 

JD22 (Level 3): 

JD30 (Level 2) : 

JD31 (Level 2): 

JD32 (Level 3): 

JD33 (Level 2) : 

JD39 (Level 2) : 



Unrecognized command . (Disk drive option is 
not installed. ) 

The device for which the directory is 
requested does not exist. 

Invalid input device specifier in parameter 
1. 

Parameter 1 memory error. (Out of memory 
while parsing the source string, or while 
executing the command . ) 

Context error in parameter 1. (The specified 
device is not a disk drive , or failed read- 
ing bit map . ) 

Disk hardware error (or drive not ready) for 
the disk drive whose directory is being 
requested. 

Invalid separator string (must be empty 
string or "TO" ) . 

Parameter 2 memory error. (Out of memory 
while parsing the separator string . ) 

The specified destination device does not 
exist . 

Invalid destination device specifier, 

Parameter 3 memory error. (Out of memory 
while parsing the destination string , or 
while executing the command . ) 

Parameter 3 context error. (The device spec- 
ified is not a valid destination device, or 
is wr ite-protected . ) 

Disk hardware error for the destination 
device. (I/O error, wr ite-protect error , or 
disk drive not ready . ) 
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Ref erences 
command . 

<Set-EOF-str ing> command . 
<Str ing> parameter type. 
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<Disable-GXN> Command 



SYNTAX 

<disable-GIN> = (ESC) (I) (D) 

<int : device- fun ct ion- cod e> * 

PARAMETERS 

Device-Function-Code* Specifies the GIN device-func- 
tion combination which is being disabled. For valid 
values, see <enable-GIN> command . 



Description 

Disables the specified GIN device-function combination. The 
device-function codes are the same as for the <enable-GIN> 
command ; see the description of that command for details . 
However , a device-function code of -1 disables all devices 
f or which graphic input is enabled . 

If the specified function is already disabled , the command 
is ignored . Likewise , if the specified device is for an 
option which is not present , the command is ignored ; an 
error is not generated. 

When a device-function combination is disabled , the terminal 
sends the rest of the <GIN-report-sequence> : the 
appropriate < term-sig-char> and <eom-indicator> . See the 
<GIN-report-sequence> description for details . 
This command does nothing but disable the GIN function on 
the named device. It leaves the device and its port ( if any) 
active and addressable for further action . 
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Defaults 

None 

Errors 

1011 (Level 2): Invalid device-function code. (See the de- 
scription of the <enable-GIN> command for a 
table of device-function codes.) 

Ref er ences 

<Enable«-gin> command. 

<GIN-r eport-sequence> message type. 
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<Disable-4953-Tablet-GIN> Command 



SYNTAX 






<disable- 


4953- 


tablet-GIN> = ' (ESC) (!) 






<disable-code> . 


<disa.ble- 


code> 


=. (8) or 






(any other ASCII character which is 






not a control character, whose sec- 






ond-least-significant bit is zero, 






and whose fourth-least-significant 






bit is one) . 



Description 

This disables the terminal' s emulation of a TEKTRONIX 4010 
Series terminal equipped with a 4953 or 4954 Graphics 
Tablet. 



References 

<Enable-4953-tablet-GIN> command . 
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<Draw> Command 



SYNTAX 




<draw> = (ESC)(L)(G) 

<xy : posit ion- in-terminal-space> . 




PARAMETERS 




« Posltion-In-Terminal-Space (X = to 4095, Y 
4095 ) . Specifies the end point of the line to 
drawn . 


s to 

be 


Description 




The <draw> command causes the terminal to draw a 
line) from the current graphic beam position to 


vector ( a 
the point 



specified in the command T s <xy> parameter . The vector is 
drawn in the current line style and line index . The graphic 
beam position is updated to the end point of the vector . 

The effect of the <draw> command is similar to that of an 
<xy> coordinate received while the terminal is in vector 
mode . However , the <draw> command does not depend on the 
terminal T s being in vector mode . 

The <draw> command does not affect the terminal ' s operating 
mode . If the terminal was in alpha mode before a <draw>, 
then it remains in alpha mode after the <draw> command is 
executed . Likewise, if the terminal was in vector mode or 
marker mode before a <draw> , it is in that same mode after 
the <draw> . 
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Defaults 



Parameter 

Number 



As Shipped 
From Factory 



On Power-Up 



If the Parameter 
is Omitted 



None 



None 



(0,0) 



Errors 



No errors are detected for this command. 
References 

<Enter-vector-mode> command. 
<Move> command. 
<Set-line-index> command. 
<Set-line-style> command. 
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<Draw-Marker> Command 



SYNTAX 






<draw-marker> = (ESC) (L) (H) 

<xy: marker-position> 






PARAMETERS 






Marker-Position (X = to 4095, Y = 

position in terminal space at which a 


to 4095). 

marker is 


The 

drawn . 



Description 

The <dr aw-marker> command draws a marker of the current 
marker type at the specified point. The marker is drawn in 
the current line index, as set by the most recent <set-line- 
index> command. The graphic beam position is updated to the 
specified point . 

The effect of the <draw-marker> command is like that of an 
<xy> coordinate received while the terminal is in marker 
mode. However, the <dr aw-marker> command does not depend on 
the terminal ' s being in marker mode . 

The <draw-marker> command does not affect the terminal ' s 
operating mode . If the teminal is in alpha mode before 
receiving a <dr aw-marker> command , then it is in alpha mode 
after the command is executed . Likewise , if the terminal is 
in vector or marker mode on receiving the command , it 
remains in vector mode or marker mode , as the case may be . 



4110 SERIES COMMAND REFERENCE REV.DEC1981 



4-97 



ALPHABETICAL LISTING 



c 



Defaults 



Parameter 

Number 



As Shipped 
From Factory 



On Power-Up 



If the Parameter 
is Omitted 



None 



None 



(0,0) 



Errors 

No errors are detected for this command. 
References 

< En ter -marker -mod e> command . 
<Set-line-index> command . 
< Set-mar ker-type> command . 



( 
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<Enable-Dialog-Area> Command 



SETUP Mode Name: DAENABLE 



SYNTAX 




<enable-dialog- 


area> = (ESC) (K)(A) 

<int : enable-mode> . 


PARAMETERS 




Enable-Mode (0 

area. 1 = YES; 


or 1 ) ♦ = NO ; disables the dialog 
enables the dialog area . 


Description 



If the <int> parameter is one , the dialog area is enabled . 
All alphatext is directed to the dialog area , at the 
position of the dialog area cursor . This occurs whether or 
not the dialog area is visible . (If the dialog area is 
invisible , the operator cannot see the alphatext being sent 
there . ) 

If the command is terminated early , so that the <int> 
parameter is missing , then the dialog area is enabled . 

If the <int> parameter is zero , the dialog area is disabled . 
Alphatext is directed to the same destination as graphics . 
In the 4114, alphatext is displayed on the screen , at the 
current graphic beam position . The graphic beam position is 
updated so as to point to the lower left corner of the alpha 
cursor . In the 4112, alphaftext is directed to the current 
view, at the current graphic beam position . ( If the graphic 
beam position is outside the window for the current view, 
then the alphatext will not appear in the viewport on the 
screen . ) 
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With the dialog area disabled , the terminal emulates earlier 
TEKTRONIX terminals which lacked a dialog area. In this 
mode , there is only one "beam position; 11 the graphic beam 
position is at the same location as the alphatext cursor. A 
number of other terminal functions are also affected; Table 
4-6 lists them; In particular , when the dialog area is 
disabled , the terminal enters alpha mode on receipt of a 
( CR) or a <page> command , or when the PAGE key is pressed* 

With the dialog area enabled , the terminal does not emulate 
earlier terminals as closely as when the dialog area is 
disabled. The only way to enter alpha mode is by turning the 
terminal on or by issuing an <enter-alpha-mode> command (the 
(US) character) .. 

Table 4-6 lists the differences between operation with the 
dialog area disabled and with it enabled. 

Table 4-6 



FEATURES AFFECTED BY THE <ENABLE-DIALOG-AREA> COMMAND 



Feature 


Effect in Mode 
(Dialog- Area Disabled) 


Effect in- Mode 1 
(Dialog Area Enabled) 


Destination 

for Alphatext 


Alphatext is directed 
to the current graphic 

beam position in 
terminal space . 

In the 4112 and 4113, 
if any- part of- an 
alphatext character 
. f alls outside, the 
current window-, that 
character is not . 
displayed in the ■ . 
current - viewport on 
the terminal 1 s screen . 


Alphatext is directed 

to the current alpha 
cursor position , at 
the end of the dialog 
area scroll . 


PAGE Key, 

<Page> Command 


IX the 4112 and 4113, 
erases the viewport 
for the current view. 
In the 4114, erases 

the screen* 

Redraws all visible 
segments . 


In the 4112 and 4113, 
erases the viewport 
f or thecurrent view. 
In the 4114, erases 
the screen . 

Redraws all visible 

segments. 
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Table 4-6 (cont) 



FEATURES AFFECTED BY THE <ENABLE-DIALOG-AREA> COMMAND 



Feature 


Effect in Mode 
(Dialog Area Disabled) 


Effect in Mode 1 
(Dialog Area Enabled) 


PAGE Key, 
<Page> Command 
( Continued) 


Exits the terminal 
from 4010 GIN mode. 

Resets line style 
to line style 1 . 

"Homes" the graphic 
beam to the upper left 
corner of terminal 
space . 

In the 4114, puts 
margin number one 
in effect . 

Puts the terminal 
in alpha mode . 




<Renew-View> 
Command 


Erases the screen ( in 
the 4114) or the 
viewport f or the 
current view ( in the 
4112 and 4113) . 

Redraws all visible 
segments . 


Erases the screen ( in 
the 4114) or the 
viewport for the 
current view ( in 
the 4112 and 4113). 

Redraws all visible 
segments . 


(CR) Character 


Puts terminal in 
alpha mode . 

Performs "carriage 
return" action . 

Resets line style 
to line style 1 . 

Removes the terminal 
. from 4010 GIN mode. 


If in alpha mode , 
performs "carriage 
return" action for the 
alphatext cursor in 
in the dialog area . 

If in vector mode or 
marker mode , does 
nothing . 
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The current value of the <enable-dialog-area> parameter is 
stored in the terminal ? s battery-powered backup memory. That 
way, the parameter is remembered even when the terminal is 
turned off. 

When the terminal is turned on again , the stored <enable- 
dialog-area> setting is used also to set the dialog area ' s 
visibility . On power-up , therefore , the dialog area is 
visible if and only if it is enabled . 



Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 Remembered 



KA11 (Level 2 ) : Parameter out of range . ( Must be or 1 . In 

SETUP mode, must be YES or NO.) 

Ref erences 

(CR) character . 
<Enable-4010-GIN> command. 
<Page> command . 
<Renew-View> command . 
<Set-line-style> command . 
<Set-margins> command . 



Errors 
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<Enable-GIN> Command 



SYNTAX 

<enable-GIN> = ( ESC) ( I ) ( E )<int> 

<int : device- f unction-cod e> 
<int+ : HruTm b er - o F-G IN - e v e n S s > . 

PARAMETERS 

DeviOi-Funotion Code. A number of the form 8D + F , 
where D is a device code and F is a function code . 
Valid values for D are ( thumbwheels) , 1 (tablet) , 
and 3 ( RS-232 peripheral ports number ) . Valid values 
for F are ( locator function) , 1 ( pick function , and 
2 ( stroke function - valid only if D = 1 ) . 

Number-of-GIN-Events (0 to 65535) . Specifies the num- 
ber of points whose position will be reported in a 
<GIN-report-sequence> before the device-function com- 
bination is automatically disabled . If this parameter 
is zero , GIN is enabled for 65535 GIN events . 



Description 

Enables the GIN ( graphic input) function on the specified 
device . The device and function are specified by the first 
integer . The second integer specifies how many events of the 
function are to occur before the function is automatically 
disabled , A function can be essentially enabled "permanent- 
ly" by specifying a very large count ( for instance , 65535). 



Undesired results may occur if the 
TermTnal i¥^TmuTtaneously enabTecT for 
graphic input with two~ diff e'FenT^en- 
abling commands . Do not use more than 
"orfe ' "of these commands at the same~THrne : 
<enabTe^GIN> , <enable-?01 0-GIN> , <en- 
abI^jir5T^ 
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The device-function combination is disabled when any of the 
following occurs: 

. The count specified in the <enable-GIN> command ex- 
pires. 

a The terminal receives a <disable-GIN> command for that 
device-function code. 

a The terminal receives a <cancel> command . 

The operator presses the CANCEL key. 

With thumbwheel GIN enabled , pressing a key with a macro 
defined for it will cause an event for each character in the 
macro which would normally be sent to the host . 

When the terminal sends a report to the host , bypass mode is 
entered . ( See < enter-bypass-mode> . ) 

Note that there are GIN devices and GIN functions. ( See 
Tables 4-7, 4-8 , ancfT^gT) " " 

Table 4-7 



GIN DEVICE ID NUMBERS 



Divioe-Cod® 


Host Program Samples 


Event Device 





Thumbwheels 


Keyboard 


1 


Tablet 


Tablet pen or puck 


3 


Peripheral Port 


CALL button , if a 

4662 plotter is 
assigned , or the 
POINT button if a 

4663 plotter is as- 
signed . 


4 


Peripheral Port 1 


Same as No.- 3 


5 


Peripheral Port 2 


Same as No . 3 
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Table 4-8 
GIN FUNCTION ID NUMBERS 



Code 


Function 





Locator 


1 


Pick 


2 


Stroke 



Table 4-9 
DEVICE-FUNCTION ID CODE NUMBERS 



Code 


Device-Function Code 
(8 times device code 




plus function code) 







Thumbwheels-Locator 




1 


Thumbwheels- Pick 




8 


Tablet-Locator 




9 


Tablet-Pick 




10 


Tablet-Stroke 




24 


Plotter at Port - 


Locator 


25 


Plotter at Port - 


Pick 


32 


Plotter at Port 1 - 


Locator 


33 


Plotter at Port 1 - 


Pick 


40 


Plotter at Port 2 - 


Locator 


41 


Plotter at Port 2 - 


Pick 
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The GIN devices are: 

* Thumbwheels. The operator uses the thumbwheels to 
position the graphic cursor and then signals a GIN 
event by pressing any ASCII key on the keyboard . 

NOTE 

If the terminal is in local mode (if the 
TTgTTF^ Ice y is onT7 ~Then 

pressing a keyboard key cannot sTgnal a 
GIN event , even though GIN may be en- 
aFTe'g^ wTETT the thumbwheels as the GT¥ 
ITevTce « The reason is that in LOCAL mode 
characters typed on the keyboard are 
TFeatedi as TT~TKey came from the host 
rather than the keyboard . 



Tablet. ( Requires Option 13 or Option 14.) The opera- 
tor positions the graphic cursor by moving a stylus 
(or four-button cursor) over the graphic tablet. He 
signals a GIN event by pressing the stylus against the 
tablet , or by pressing a button on the tablet cursor . 

Peripheral ports. (Requires Option 10 . ) The operator 
positions the graphic cursor by moving the joystick on 
a TEKTRONIX 4662 or 4663 plotter connected to an RS- 
232 peripheral port. (This requires that Option 10, 
the Three Port Peripheral Interface , be installed in 
the terminal.) The operator signals a GIN event by 
pressing a switch on the plotter . ( On the 4662 
plotter , this is the CALL switch; on the 4663 , the 
POINT switch is used.) 



NOTE 

When graphic input is done from a plot- 
ter , the position on the screen of the 
graphic cursor is not updated until the 

operator signals a GIN event by pressing 
a switch on the plotter . 



4-106 



REV, DEC 1981 4110 SERIES COMMAND REFERENCE 



ALPHABETICAL LISTING 



NOTE 

In the 4112 and 4113, moving the 
thumbwheels Tor other GIN device) posi- 
tions the graphic cursor i T P4 "9 6^by^T09 6 
t e r mTn aT~s pace . "Ho wever , TEe cursor 
which the operator actually sees is the 
image TTn "640-by-*T80 raster memory 
space)~~oT TSTreHsr u Fc u rsor . How tTTe visi- 
ble image moves depends on the current 
window- viewport transform , which maps 
obj e cts ~Tn ~~ t el^inaT^spac^to their cor- 
responding images in raster memory 
space . 

On power-up f several points in terminal 
space map to each pixel in raster memory 
space. Thus, when moving"The tfiumbwTieeTs 
"slowly , it is possible to move the true 
cursor (whose posiETon" Tn terminaT space 
13 reported to the hostT^without produc- 
ing any visibTe motion m ~the image oT~~ 
that cursor in 6T0^Fy^4?0 raster memory 
space . 

Likewise , if the window i_n terminal 
space is very smaTTHTas wh e n" ' t He ^op e r a - 
tor has "zoomed in Tt to see more detaTTT, 
then adjacent points in terminal space 
may have images in "The current viewport 
which are separated by some smaTT~ffTs^ ~ 
tance , In that case , as the operator 
moves tHe cursor in terminal space , the 
image of tHaT^cur sor" ^ lnoves~Tn short 
steps from place to place in raster 
memory space . 
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The GIN functions are: 

• Locate* Returns x- and .' y-coor.dinates for a particular 
location . (This is the location in terminal space of 
the graphic cursor. For fur ther information , see the 
<gin-locator-report> description, elsewhere in this 
section . ) 

• Pick* Compares all detectable segments within the pick 
aperture ,. returning the segment number, and '. pick-i . d . 

of the highest-priority such segment, together with 
the <xy> coordinate of the graphics cursor . For fur- 
ther information , see the <GIN-pick-*report> 

description, elsewhere in this section/ 

s Sfcrokit Sends a continuous stream of x- and y-coordi- 
nates to the host. Currently only the graphics tablet 
can be used with the stroke function. For more infor- 
mation, see the ■ <gin-stroke-report> command descrip- 
tion . 



Example. To enable the graphics tablet for five events of 
the locator function : 

<enable-GIN : tablet-locator, 5 events) 
= (ESC) (iMEXint: 8><int: 5> 
= (ESC)(I)(E)(8)(5) . ■ 

Here the locator function on the graphics tablet is enabled 
for five events, after which the locator function is 
automatically disabled. 

Example • One may wish to enable a graphics function "perman- 
ently" - that is , until specifically disabled with a <dis- 
able«~G!N> command. To do this , one simply enables for a very 
large number of events (e.g. , 32 ,767 ) . For instance : 

<enable-GIN : tablet-pick, 32767 events 

= (ESC) (I)(E)<int : 9><int : 32767> 
= (ESC)(I)(E)(9)( MDELM?) . 
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Number Of GIN Events. The second parameter in the is of 
parameter type <int+> ; that is, it represents an integer in 
the range from to 65535- (See the description of the <int> 
and <int+> parameter types for details . ) This parameter 
specifies the number of GIN events for which the terminal is 
enabled. 

If this parameter is zero, the terminal is enabled for the 
maximum number of GIN events ( 65535 ) . Otherwise , the termi- 
nal is enabled for the number specified by the <int+> 
parameter . 



Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 None None 

2 None None' 65536 
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Er ror s 



1011 (Level 2) 

1011 (Level 2) 
IE00 (Level 2) 



IE03 (Level 2) 

IE10 (Level 2) 
IE 1 3 (Level 2) 



IE21 (Level 2) 



Invalid dev ice- function code . (See the 
description of the < enable-GIN> command for 

a table of device-function codes.) 

Invalid device- function code. 

The cursor segment for the specified device- 
function code does not exist. (It has been 
deleted since the < set-G IN- cur so r> command 
which assigned it to that d ev ice- f unc tion 
code . ) 

Command is inval id at this time . -(The seg- 
ment being used as the cur sor for the spec i- 
fied device- function code is a segment which 
is currently being defined . ) 

The specified GIN device is not installed in 
the terminal . 

The specified GIN device is invalid at this 
time ,' or the terminal run s out of memory 
while initial izing for graphic input . A GIN 
dev ice is " inval id at this time" if it is 
busy , if it is already enabled for GIN , or 
if it is a peripheral port to which a 
plotter protocol has not been < port-as- 
signed . 

Inv al id number of GIN events . (Must be in 
the range from to 65535 . ) 
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<Enable-4010-GIN> Command 



SYNTAX 

<enable-4010-GIN> = (ESO(SUB) . 



Description 

This command is provided for compatibility with software 
written for earlier TEKTRONIX terminals. It provides an 
abbreviated way of enabling the thumbwheels for one GIN 
( graphic input) "locator" event . The report which the termi- 
nal sends in response to this GIN event is in the <401 0-GIN- 
r eport> f ormat , rather than the <GIN-report-sequence> format 
used with the <enable-GIN> command . 



Undesired results may occur if the 
terminaT~i"s ' simultaneously enabled" for 
graphic input with two different en- 
abling commands . Do not use more than 
one of TEese commands at ~ the same"~time : 
TenaFTe^TlT ? "~<en¥bTe-Tg1"g^IN> , <en- 
able-4953-tablet-GIN> . 



When the terminal receives an <enable-401 0-GIN> command - 
the sequence of characters ( ESC) ( SUB) - it displays the 
graphic cursor assigned to device- function code zero . ( The 
default cursor is the crosshair cursor ; however , this may be 
changed with the <set-GIN-cur sor> command . ) 

The operator may then position the cursor by moving the 
thumbwheels . (The possible cursor positions are determined 
by the most recent <set-gin-gridding> command for device- 
f unction code zero - thumbwheels device , locator f unction . ) 
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When the cursor is at the desired location , the operator 
presses any of the ASCII keys on the keyboard; this signals 
a "GIN event." In response to this GIN event, the terminal 
sends a <4010-GIN-report>. That report tells the host (a) 
which key the operator pressed , and (b) the location of the 
crosshair cursor in the 4096-by-4096 terminal space. 

When thumbwheel GIN is enabled, pressing a key which has a 
macro defined for it will cause an event for each character 
of the macro which would normally be sent to the host. 

When the terminal sends a report to the host, bypass mode is 
entered* (See <enter-bypass-mode> . ) 

After sending the <401 0-GIN-report> , the 4110 sets its 
graphic beam position to the position of the graphics 
cursor, and enters alpha mode . The alpha cursor is now at 
the position reported in the <4010-GIN-report> . (This is 
done for compatibility with host programs written for use 
with TEKTRONIX 4010 Series terminals.) 

If the dialog area is not enabled, then receiving a ( CR) 
character , or a <page> command , cancels the effect of the 
<enable-401 0-GIN> command and places the terminal in alpha 
mode . Pressing the PAGE key has the same effect as the 
<page> command . For details, see the description of the 
< en able- dialog-are a> command . 

If the dialog area is enabled , then the PAGE key , the <page> 
command , and the ( CR ) character have no effect on graphic 
input; they do not cancel the effect of the <enable-401 0- 
GIN> command. 
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Terminal Settings For Emulating 4010-Series Graphic Input. 
To properly emulate a TEKTRONIX 4010-series terminal during 
graphic input, several of the terminal's settings must be 
set a certain way. The exact settings may vary from one 
computer installation to another. Table 4-10 lists settings 
which should work for most host computers „ 

Table 4-10 

TERMINAL SETTINGS TO EMULATE 4010-SERIES GRAPHIC INPUT 



Escape-Sequence Command 


Equivalent Setup 
Mode Command 


<set-report-EOM- frequency: 1 > 
= (ESC)(I)(M)(1) . 


REOM 1 


<set-EOM-chars : , 0> 

= (ESC)(N)(C)(0)(0) . 


EOMCHARS 


<set-EOL-string: (CR)> 

= (ESC) (N) (T) 

<int-array: ( 1 3 ) > 

= (ESC)(N)(T)(1)(=) . 


EOLSTRING '<CR>' 


<set-byp ass-can cel-char> 

= (ESO(NMU) 

<int : bypass- cancel-char> . 


BYPASSCANCEL <CR> 
BYPASSCANCEL <NL> 
BYPASSCANCEL <LF> 
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Set the <byp ass-cancel -char> to whatever is the last 
character which the host echoes in response to a 
report message from the terminal. If the host is not 
echoing characters sent from the terminal, set the 
<bypass-cancel-char> to ( NUL ) . If the host echoes ( CR) 
as ( CR) (LF) , set the <bypass-cancel-char> to (LF) . If 
the host echoes ( CR ) as exactly ( CR) , set the <bypass- 
cancel-char> to (CR). 



References 

<401 0-GIN-report> syntactic construct . 
<Enable-GIN> command . 
command . 

<Set-EOL-str ing> command . 
<Set-EOM-char s> command . 
<Set-GIN-cursor> command . 
<Set-GIN-gr idding> command . 
command . 
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ALPHABETICAL LISTING 
(Options 13 and 14) 



SYNTAX 

<enable-4953~tablet-GIN> = (ESC)(!) 

<enable-code> . 

<enable-code> = ( an ASCII character in which , if the 

fourth-least-signif icant bit is one , 
then the second -least- significant bit 
must also be one) . 

PARAMETERS 

Enable-Code. A seven-bit ASCII character whose least- 
significant bits hold tablet control information : 



b7 


b6 


b5 


b4 


b3 


b2 


b1 


X 


X 


A 


B 


C 


D 


X 



X "Don't care." (May be or 1), 

A If 0, the terminal returns 1 0-bit coordinate data 
to the host . If 1 , 12-bit data is returned . 

B If 1 , lifting the pen out of presence disables the 
tablet . 

C , D Together determine tablet operation : 
C D Analogous <Enable-GIN> command 

Tablet-locator , one GIN event . 

1 Tablet-locator, 65535 GIN events. 

1 Tablet-locator , one GIN event . 

1 1 Tablet-stroke, 65535 GIN events. 



4110 SERIES COMMAND REFERENCE REV, DEC 1981 



4-115 



ALPHABETICAL LISTING 



Description 

This command is provided for (partial) compatibility with 
software written for earlier TEKTRONIX terminals . When 
graphic input is enabled with this command (rather than the 
<enable-GIN> command), the 4110 emulates a TEKTRONIX 4010 
Series terminal equipped with a TEKTRONIX 4953 or 4954 
Graphics Tablet . 

This command is only available if the 4110 terminal is 
equipped with an accessory graphics tablet ( Option 13 or 
Option 14) . 




Undesired results may occur if the ter- 
minal is simultaneously enabTed f or 
graphic input with two different en- 
ablin g commands . Do not use more than 
one oT TTTFsF^cornmands atTHe same time : 
<enable-GIN>, <enable-¥0 1 0-GIN> , <en- 
able-4953-tablet-GIN> . 

<iHlbla«Code> • The <enable-code> parameter is a seven-bit 
ASCII character whose least- significant bits hold control 
information for the tablet , as follows : 



b7 


b6 


b5 


b4 


b3 


b2 


b1 


X 


X 


d 


d 


d 


d 


X 



X = "don't care" (may be zero or one) 

d = data ( control information for the tablet) 



b?f b6 i "Don 1 1 cares," At least one of these bits should be 
non-^zero, so that the <enable-oode> is not one of the 
ASCII control characters , whose decimal equivalents 
range from to 31. ( Some of the control characters , 
such as ( ESC) or ( CR) , have special effects on the 
terminal . ) 
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fe§! Bit b5 controls whether the 4110 is to return 10-bit or 
12-bit coordinate data to the host. If this bit is 
zero, then x- and y-coordinates which the terminal 
sends to the host will each include only 10 binary data 
bits . If this bit is one, then the x- and y-coord inares 
reported to the host will each include 12 data bits. 
(For details, see the description of the <4953-tablet- 
GIN-report> , elsewhere in this section.) 

b4 l Bit b4 determines the effect of lifting the pen (or 

four-button tablet cursor) away from the tablet. (This 
is called "removing the pen from presence.") If this 
bit is one, then lifting the pen out of presence 
disables the tablet, almost as if a <disable-4953- 
tablet-GIN> command were received. If bit b4 is zero, 
then lifting the pen out of presence does not disable 
the tablet. 



b3 and b2: For 4010 Series terminals equipped with the 4953 
or 4954 graphics tablets , bit b3 is the "presence" bit , 
and bit b2 is the "multiple-point" bit . In the 4110 
terminal , these bits may perhaps best be explained by 
saying that they together determine which 4110 <enable- 
GIN> command most closely resembles this <enable-4953- 
tablet-GIN> command : 



b3 b2 Function 

Analogous to an <enable-GIN> command for the 

tablet device , locator function , and one GIN 
event . 



1 Analogous to an <enable-GIN> command for the 

tablet device , locator function , and 32767 
GIN events . 



1 Analogous to an <enable-GIN> command for the 

tablet device , locator function , and one GIN 
event . 

1 1 Analogous to an <enable-GIN> command for the 

tablet device , stroke function , and 32767 
GIN events . 
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fell In a 4010 Series terminal equipped with a 4953 graphic 
tablet , bit b1 determines whether the terminal is to 
display locally the position data which is being sent 
to the host computer . The 4110 always assumes that this 
bit is 1 , causing the terminal to display the graphic 
cursor ,T f the "st rok e" funct i on or "mult i-po int loca- 
tor function" is enable (bit b2 set to one) , then the 
4110 performs " inking , " as if a < set-GIN-inking> 
command had been issued . 

After the Report is Sent . If the terminal is enabled f or 
single-point GIN (that is , if the <enable-code> 1 s bit b2 is 
zero) , ' then it sends a single <4953-tablet-GIN-report> to 
the host • After sending this report , the 4110 enters alpha 
mode • On entering alpha mode , the alpha cursor's lower left 
corner is at the point whose position was just reported to 
the host in the <4953-tablet-GIN-report> . 

Likewise , if the terminal is enabled for multiple-point GIN 
( that is , if the <enable-code> 1 s bit b2 is one) , then it 
enters a graphic input mode and can send many <4953-tablet- 
GIN~report>s to the host . It exits this graphic input mode 
on receiving a <disable-4953-tablet-GIN> command or a <can- 
cel> command , or when the the CANCEL key is pressed . When 
this occurs , the terminal enters alpha mode , and the alpha 
cursor is at the last point whose position was reported to 
the host . 



Emulating 4953/4954 Strap Settings 

As mentioned before , the purpose of the <enable-4953-tablet- 
GIN> command is to let the 4110 terminal emulate an earlier 
TEKTRONIX 4010-series terminal with an accessory 4953 or 
4954 graphics tablet . However, to do this correctly , the 
4110 must emulate certain strap settings on the 4953/4954 
Tablet Control Board . 
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Table 4-11 lists the 4953/4954 Tablet Control Board strap 
settings , together with the commands for the 4110 which 
emulate these strap settings. Before using a 4110 with an 
existing program designed for the 4953/4954 graphics tablet, 
you should first issue the appropriate commands from this 
table. 



Emulating Other 401 0-Series Terminal Settings 

Besides the settings which emulate straps on the 4953/4954 
Tablet Control Board, there are certain other terminal 
settings which must be set to emulate 401 0-series graphics 
terminals . Please refer to Table 4-10, in the description of 
the <enable-401 0-GIN> command . 
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Table 4-11 

EMULATING 4953/4954 STRAP SETTINGS 



Strap 


Strap Setting 


Equivalent 41 1X' Commands 


CR 


IN 


<set-report-EOM- frequency: 1 > 
<set-EOL-string : ( 1 3)> 




OUT 


<set-r epor t-EOM- frequency : 0> 
<s et-re port -max -line- length: 0> 


HEADER 


CONTROL 


<set- tab let-header-characters: 0> 




LETTER 


<set-t ablet-header-characters: 1 > 


LARGE/SMALL 




The terminal automatically emulates this 
strap. That is , the terminal automati- 
cally determines whether the small ta- 
blet (Option 13) or the large tablet 
(Option 14) is attached . 


DELAY 


IN 


<set-transmit-delay: 25> 
or <set-transmit-delay : 50> 




OUT 


<set-transm it-delay: 0> 


ESUP 




In the 4110 terminal, echo suppression 
is handled by the "bypass mode" 
associated with GIN . There is no need to 
emulate the ESUP (echo suppression) 
strap . 


COMSUP 




The 4110 terminal always emulates the IN 
position of the COMSUP strap. 


STATUS 


IN 


■< set- tablet- status- strap : 1 > 




OUT 


<set-t ablet- status-strap: 0> 
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Errors 



1100 (Level 2): Unrecognized command (Option 13 or 14 not installed) . 
References 

TEKTRONIX 4953/4954 Graphics Tablet Instrucion Manual. 

<Disable»-4953-tablet-GIN> ommand. 
<Enable-GIN> command. 
<Set-GIN-inking> command. 
<4010-status-report> syntactic construct. 
<4953-tablet-GIN-report> syntactic constuct. 
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c 



<End-Fill~Pattern> Command 



4112, 4113 



SYNTAX 

<end-fill-pattern> = (ESC) (M)'(E) . 



Description 

This command terminates a <f ill-pattern-def inition> . 

Defaults 

Firameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 



No errors are detected for this command . 
No errors are detected for this command . 



References 

< Beg in- f ill- patter n> command . 

<Fill-pattern-definition> syntactic construct . 



None required 



None required 



None required 



Errors 



c 



c 
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<End-Graphtext-Character> Command 
SYNTAX 

<end-graphtext-character> = (ESC) (S) (U) • 



Description 

Terminates the graphtext character currently being defined. 
Defaults 

Parameter As Shipped On Power-Up If the Parameter 



Number 



From Factory 



is Omitted 



None required 



None required 



None required 



Errors 



SU03 (Level 



1 ) : This command is invalid at this time . (No 
graphtext character is being defined . ) 



Ref er ences 



< Beg i n- graph text- char acter> command . 
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<End-Panel> Command 4112, 4113 



SYNTAX 




<end-panel> = 


: (ESC) (L) (E) . 



Description 

This command terminates a <panel-definition>. The current 
panel boundary is closed , setting the graphic beam position 
to "starting point" of the panel boundary (that is, the 

coordinate specified in the command)* 

If the current fill pattern number (as specified by the most 
recent <select-f ill- patter n> command ) is greater than -8 ( in 
the 4112) or -15 (in the 4113), and that fill pattern 
exists , then the panel interior is filled with that fill 
pattern . The fill occurs in "over strike" or "replace" mode 
according to the "over strike/replace" parameter in the most 
recent < set- panel- f il ling-mod e> command „ 
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Defaults 



Parameter 
Number 



As Shipped 
From Factory 



On Power-Up 



If the Parameter 
is Omitted 



None required 



None required 



None required 



Error s 



LEOO (Level 0): Unrecognized command. (The terminal is not a 

4112 or a 4113). 

LE03 (Level 1): No panel is currently being defined. 

LE02 (Level 3 ) : Out of memory while performing <end-panel> 

command . 

References 

< Begin-fill-patter n> command . 
< Beg i n- pan el- bound ary> command . 
<Panel-definition> syntactic construct . 
<Select-fill-pattern> command . 
command . 
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c 



<End-Segment> Command 



SYNTAX 




<end-segment> = 


: (ESC) (S) (C) . 



Description 

If a segment is currently being defined, this command 
terminates that segment definition . If a panel is currently 
being defined within the segment, that <panel-definition> is 
also terminated , as if an <end-panel> command had been 

received . . ■ ' . 

In the 4112 and 4113, the view which is selected at the time 
of the <end-segment> command is the view in which the 
segment is visible . ( Unless , of course , a <set-segment- 
visibility> command for "segment -2" has determined that 
newly-created segments are to be invisible . ) 

c 

Defaults 



Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

None required None required None required 

Errors 



SC03 (Level 



SC02 (Level 



References 
<Begin-segment> command . 



c 
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<Enter-Alpha-Mode> Command 



SYNTAX 




<enter-alpha-mode> = 


: (US) . 



Description 

Puts the terminal in alpha mode. 

While the terminal is in alpha mode , it interprets any ASCII 
characters it receives ( except those comprising commands) as 
text to be displayed. If the dialog area is enabled , this 
" alphatext" is sent there . 

In the 4114, if the dialog area is not enabled, then 
alphatext is directed to the screen , where it is written in 
storage mode . 

In the 4112, the dialog area is not enabled , alphatext is 
directed to the current view, at the current graphic beam 
position in 4096-by-4096 "terminal space . " (If this location 
falls outside the current view's window , then the alphatext 
does not appear in the current viewport . ) 

The terminal leaves alpha mode on receiving an <enter- 
vector-mode> or < en t er -marker -mod e> command . 

On the 4114, alphatext may appear in any of a variety of 
character sizes , according to the most recent <set-alpha- 
text-size> or <set-40l4-alphatext-size> command . If Option 
4E is installed , the alphatext may also appear in the APL 
character font ; this is controlled by the <set-alphatext- 
f ont> command . 

If an optional keyboard is installed on a 4112, the alpha- 
text may appear in the APL character font ( for example) ; 
this is controlled by the <set-alphatext-font> command . 
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In alpha mode , a carriage return (CR) moves the cursor to 
the beginning of the current line -unless a <crlf: Yes> has 
been issued. In that case, (CR) moves the cursor to the 
beginning of the next line. 

In alpha mode , a line feed (LF) moves the cursor down one 
line , but at the same line position— unless a <lfcr: Yes> 
command has been issued* In that case, the (LF) moves the 
cursor to the beginning of the next line . 

When a segment is being defined and the dialog area is 
disabled, the "warp-around" features of alphatext- are 
disabled. When the next character to be displayed would end 
past x = 4095 , it is not displayed and the cursor position is 
left unchanged. Similarly, a ( BS) character is not processed 
if the resulting x-position would be less than zero . Like- 
wise, a ( CR) is not processed if the resulting y-coord inate 
would be less than zero , and a ( VT) is not processed if the 
resulting y-coordinate would be greater than 3071 . 



References 

(CR) Character. 
<Enable-Di alog-Ar ea> command . 
<Page> command . 
<Crlf > command . 
<Lf cr> command . 
<Set-alphatext-size> command . 
<Set-4014-alphatext-size> command . 
<Set-aiphatext-font>. command, 
<Enter-vector-mode> command . 
<Enter-marker-mode> command. 
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<Enter-Bypass-Mode> Command 




SYNTAX 




<enter-bypass-mode> = (ESC) (CAN) . 




Description 




The terminal includes a "bypass mode," 


in which characters 



coming from the host are ignored until a special "bypass 
cancel character" is received . This mode is provided primar- 
ily for use when the terminal is sending report messages to 
the host* (Without the bypass mode, a host which provides a 
remote echo could cause problems, as the echoed characters 
would be received by the terminal and executed as commands . ) 

However, there are circumstances when it may be helpful for 
the terminal to enter bypass mode even though the terminal 
is not sending a report to the host. The <enter-bypass-mode> 

command provides this facility. 

For instance, in "half duplex local echo" data communica- 
tions, the host can issue an <enter-bypass-mode> command to 
temporarily suppress the terminal's local echo while the 
operator types in a password. 

Entering Bypass Mode. Of course, the terminal enters bypass 
mode when it receives an <enter-bypass-mode> command. 
Besides this , it also enters bypass mode when it sends the 
first character of each line of a message to the host 
computer - except for messages typed by the operator . For 
this purpose , "the first character of each line" means "the 
first character of the message , or the first character 
following an <eom-indicator> or <eom-char> within the mes- 
sage . " 
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For instance: 

. If the terminal is sending <eom-indicator> s after each 
<GIN-report> within a <GIN-r epor t-sequence> ( that is , 
if the < report- EOM-frequ en cy> setting is "more fre- 
quent" ) , then the terminal enters bypass mode as it 
sends the <sig-char> that precedes each <GIN-report> 
in the <GIN-report-sequence>. (See the description of 
<GIN-report-sequence> for details . ) 

# If the terminal is executing a <copy> f rom a disk file 
to the host computer , then it enters bypass mode on 
sending the first character of that file to the host . 
If the file contains <eom-char>s ( such as ( CR) charac- 
ters , for instance) , then the terminal enters bypass 
mode again as it sends the first character after each 
<eom-char> , 

Exiting Bypass Mode* The terminal exits bypass mode when it 
receives the current bypass cancel character , as set by the 
most recent <set-bypass-cancel-char> command . ( It also exits 
bypass mode in response to the <cancel> command or the 
CANCEL key . ) • 

For instance , suppose that the current <EOM-char> is (CR); 
that the current <EOL-str ing> consists of the single 
character , (CR); and that the host computer echoes each ( CR) 

as (CR)(LFK 

Then as the terminal sends each line of text to the host , 
the last character in each line sent to the host is ( CR ) , 
and the last character in the echo of each such line is 
(LF) . The (LF) character, then, should be selected as the 
< bypa s s- can eel- char > . 

As the terminal sends the first character of each line of a 
message to the host , it enters bypass mode . In bypass mode , 
the terminal ignores the characters which the host echoes 
back to it. The last character in the echo , (LF) , is the 
<bypass-cancel-char> and removes the terminal from bypass 
mode . 
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NOTE 

If the current <bypass-cancel-char> is 
TNUL ) , then the bypass mode feature is 
disabled . In that case , the <enter-by- 
pass-mode> command has no effect . 



References 

<Set-bypass-cancel-char> command . 
<GIN-r epor t-sequence> message type • 
<Copy> command . 
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<Enter-Marker-Mode> Command 



SYNTAX 




< enter -mar ker-mode> = 


= (FS) . 



Description 

The <enter-marker~mode> command places the terminal in mar- 
ker mode* Once in marker mode , subsequent alphanumeric 
characters are interpreted as <xy> parameters specifying 
coordinates at which markers are to be placed. Each <xy> 
coordinate received in marker mode not only causes a marker 
to be drawn , but also updates the graphic beam position . 
Markers are drawn in the current line index, as set by the 
most recent <set-line-index> command. 

The format of the <xy> parameters is the same as that used 
with the <enter~vector-mode> command . See the description of 
the <xy> parameter type for details* 

The terminal leaves marker mode on entering alpha mode . 

While in marker mode, the < en t er- vector -mod e> command has no 
effect. (To go from marker mode to vector mode , you must 
first place the terminal in alpha mode.) 

The <enter~marker-mode> command (that is , the (FS) charac- 
ter) also has the effect of terminating any command which 
precedes it. This is described in Section 2, under the 
heading "Commands of More Than Three Characters . " 



Ref erences 

<Dr aw-marker> comamnd » 
<Set-marker-type> command . 
<Xy> parameter type . ■ 
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<Enter-Vector-Mode> Command 



SYNTAX 




<enter-vector-mode> = 


: (GS) . 



Description 

The <enter-vector-mode> command places the terminal in 
vector mode . Once in vector mode, subsequent alphanumeric 
characters are interpreted as <xy> parameters specifying 
positions between which vectors are to be drawn. 

The first <xy> parameter received after an <enter-vector- 
mode> command designates a position to which the graphic 
writing beam is moved. (An exception to this occurs in the 
case of a (GS) (BEL) sequence; see the (BEL) character 
description for details.) Subsequent <xy> parameters specify 
points to which "draws" are to be performed. 

The <enter-vec tor-mod e> command (that is, the (GS) charac- 
ter) also has the effect of terminating any "escape se- 
quence" command which may precede it. This is described in 
Section 2, under the heading "Commands of Three or More 
Characters . " 



Ref erences 

<Dr aw> command. 
<Move> command . 

<Xy> parameter type. 
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<EOF-String> Syntactic Construct 



Description 

The <EOF-string> (end-of-file string) is a sequence of up to 
ten ASCII characters. It is used in and operations to mark 
the end of a file transfer between the terminal and the host 
computer. (If the terminal is in block mode, the end-of-f ile 
bit in the <block-control-bytes> is used instead of the 
<EOF-str ing> . ) 

NOTE 

When the terminal is armed for block 
mode or in block mode f it "does not 
"gTeTTe cT"<ET}F" :: ¥^rTn g > s comi ng^TFonTTh e 
host computer , Therefore , if you are not 
using block mode , you should be sure 
tTiat tTie terminal is nolTlirmeT " ~f cnrH51ock 
mode . 



References 

<Arm-for-block-mode> command . 
<Copy> command . 
<Port-Copy> command . 
<Set-EOF-str ing> command . 
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<EOL-String> Syntactic Construct 



Description 

The <EOL-str ing> ( end-of-1 ine string) is a sequence of one 
or two ASCII characters which mark the end of a "line" of 
text in reports which the terminal sends to the host 
computer. 

For data typed on the keyboard, each "line" of text ends 
with an <eom-char> , set by the <set-EOM-char s> command . 
Typically , this is ( CR) . Thus , whenever the operator presses 
RETURN, it marks the end of a line of text. 

However , f or text sent to the host which the terminal 
originates , the mechanism is different . ( Such text might be 
GIN reports , for example . ) The terminal inserts <EOM-indica- 
tor>s at specific points in the reports it sends to the 
host . Each <EOM-indicator> marks the end of a line of text 
being sent to the host . If the terminal is not in block 
mode , the <EOM-indicator> is sent as a <EOL-string> . (If in 
block mode , a different mechanism is used ; see the <E0M- 
indicator> description for details . ) 

After sending each <EOL-string> , the terminal waits for the 
current transmit delay before transmitting the first charac- 
ter of the next line of text . 



References 

<EOM-char> characters . 
< EOM- indicator > syntactic construct . 
<Set-EOL-str ing> command . 
<Set-EOM-char s> command . 

Syntax of individual reports : <GIN-r eport-sequence> , termi- 
nal-setting s-report>, etc . 
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<EOM-Char> Characters 



Description 

Data sent from the terminal to the host is divided into 
"lines" of text. At the end of such line, the terminal 
pauses (for the current transmit delay) before sending the 
next line . This gives the host computer a chance to "talk 
back" to the terminal. (This is especially important in half 
duplex data communications , in which the terminal and the 
host cannot simultaneously use the communications 1 ine . ) 

Clearly, then, when the terminal is transmitting data to the 
host it must have a way to know when it has reached the end 
of a line.. There are two mechanisms for this: <E0M-char>s 
and <EOM-indi.cator>s . 

If the operator is typing on the terminal's keyboard, then 
the end of each line (or "message") is marked by a special 
character: the ' <EOM-char> . Typically, the <EOM-char> (end- 
of-message character) is the carriage return character, 
( CR) . Whenever the operator presses RETURN , the terminal 
transmits the ( CR ) character ; it then waits for the transmit 
delay to expire before transmitting the first character of 
the next line . 

( For messages which the terminal itself originates --'rather 
than messages typed by the operator - a dif f erent mechanism 
is used . For details, see the description of the <EOM- 

indicator> syntactic construct.) 

The <E0M-char>s ( and <EOM-indicator> s ) also play a role in 
block mode commnunications . When the terminal encounters an 
<EOM-char> (or <EOM-indicator> ) in the characters it is 
packing into a block, the terminal ends the block and and 
sets the end-of-message bit in the <block-control-bytes> . 
( The <EOM-char> is packed into the block . ) 

By means of the <set-EOM-char s> command , you can specify one 
or two characters to serve as the current .<E0M-char>s. 
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References 

< Block-control- by tes> syntactic construct . 
<EOM-indicator> syntactic construct . 
<Set-block-packing> command. 
<set-EOM-char s> command. 
<Set-transmit-delay> command. 
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<EOM-Indioator> Syntactic Construct 



SYNTAX 










<EOM-indicator> 


= <E0L-strin 


g> 








or <block- 


mode-end- 


of-message> < 




< block-mode- end - 


-of-message> 


= the end 


of a block , 


in 






which the end-of-message 






bit has 


been set in 


the 






<block- 


control-bytes> . 



Description 

Data sent from the terminal to the host is divided into 
"lines" of text . At the end of such line , the terminal 
pauses ( for the current transmit delay) before sending the 
next line . This gives the host computer a chance to "talk 
back" to the terminal . (This is especially important in half 
duplex data communications , in which the terminal and the 
host cannot simultaneously use the communications line . ) 

Clearly , then, when the terminal is transmitting data to the 
host it must have a way to know when it has reached the end 
of a line . There are two mechanisms for this : <EOM-char>s 
and <EOM-indicator>s . 

<EOM-char>s are used for data which the operator types on 
the keyboard . ( See the description of the <EOM-char> 
characters for details . ) 

For messages ( such as GIN reports) which the terminal itself 
originates , <EOM-indicator>s mark the end of the "lines" of 
text . The syntax of the particular report being sent deter- 
mines at which point in that report these <EOM-indicator>s 
occur . ( See , for example , the descriptions of <GIN-report- 
sequence> and <error s- report > syntactic constructs . ) 
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If the terminal is not in block mode , then it sends each 
<EOM-indicator> as the current <EOL-string> . This marks the 
end of the line of text . Having sent the <E0L-str ing> , the 
terminal then pauses ( for the current transmit delay) before 
sending the first character of the next line . 

In block mode , the terminal sends each < EOM- indicator > by 
terminating the block and setting the end-of-message bit in 
the <block-control-bytes> . 



Ref erences 

< Bio ck- control- by tes> syntactic construct . 
<EOM-char> characters . 
<Set-block-packing> command . 
< set- EOM- char s> command . 
<Set-report-EOM-frequency> command . 
<Set-transmit-delay> command . 
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<Error-Report> Message Type 



SYNTAX 



<error-report">- = [.<report-f or.-pn.e-error> . . . ] 

[ <term : -sig-char> ] 
<EOM-indicator> ... 



(See note 1 * ) 



< report- for-one- err or > = [ <EOM-indicator> ] 

[ <sig-char> ] 

< err or- code- report > 



(Set note 2«) 

(See note 1 • ) 



<int-report : 
<int-report : 



sever ity-level > 
error-count> 



[<EOM-indloator7!F7 



TSee note 3.) 



<error-code-report> 



= ■ <char-report> 
<char-report> 
<char-report> 
<char-report> 



Note 1 • A signature character ( <sig-char> or <term- 
sig-char> ) is only sent if it is not the ( NUL) 
character . 

Note 2. This <EOM-indicator> is sent only if required 
by the terminal f s "maximum report line length" fea- 
ture. That is , it is sent if both the following 
conditions are met : ( a) at least one character has 
already been sent on this line ( that is , since the 
last <EOM-indicator> ) , and ( b) if all the following 
characters in this <report-for-one-error> were to be 
sent as part of this line , then the current maximum 
report line length would be exceeded . 

Note 3 • This <EOM-indicator> is sent only if the most 
recent <set-repor t-EOM- frequency > command specified 
"more frequent" rather than " 1 e s s frequent . " 
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Description 

The terminal sends an <error-report> message in response to 
a <report-error s> command. In that <error-repor t> , there is 
one <report-for-one-error> message for each of the eight 
most recently detected error codes. (If fewer than eight 
errors have been detected - since power-up or since the last 
<report-error s> command - then there are fewer than eight 
reports- for-one- err or in the <error-r eport> message.) 

Each <report-for-one-error> is preceded by a <sig-char> , as 
set by the <set-report-sig-chars> command . After the last 
<re po rt- for-one- err or >, theterminal sends a <term-sig^char> 
and an <EOM-indicator> ; this signals the end of the <error- 
report> message . 

( You should not set the <sig-char> or < term- si g- char > to 
( NUL ) , as doing so causes them not to be sent . That would 
make it difficult for the host to parse the <error-report> 
message . ) 

Besides the <sig-char> , each <report-f or-one-error> includes 
a four-character error code , a severity level number , and 
the number of times the terminal has detected that error 
( since power-up or the last <report-error s> command ) . The 
error codes and severity levels are described in Appendix C . 



References 

Appendix C , "Error Codes . " 

< Report- err or s> command . 
<Set-report-sig-chars> command . 
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(ESC) Character 



Description 

The ASCII "escape" character - ( ESC) - is used to signal the 
terminal that the next few characters comprise a command for 
it. This character also terminates any command currently 
being sent to the terminal. 



Ref erences 

"Command Syntax," in Section 2. 
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<Expand-Macro> Command 



SYNTAX 

<expand-macro> = (ESC)(K)(X) 

< int : macro-number) . 

PARAMETERS 

Macro-Number (0 to 32767)* Number of the macro whose 
definition is being invoked. 



Description 

The <expand-macro> command causes the terminal to insert 
into its current input data stream the contents of a 
programmed macro definition ( or key definition) . It is a 
companion command to the <def ine-macro> command , which de- 
fines a macro ( or programs a meaning into a key) . 

If the <expand-macro> command comes from the host computer , 
it is treated by the terminal as if the host computer had 
sent the contents of the macro which is being expanded . 
Likewise , if the <expand-macro> command comes to the termi- 
nal from a disk file which is being <load>ed , it is treated 
by the terminal as if the disk file had included the 
contents of that macro . 

( Macros numbered from to 1 43 may also be expanded by 
typing the corresponding ASCII character on the keyboard , or 
by pressing a function key . ) 
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The macro definition which is being expanded may contain 
other <expand-macro> commands (and <load> commands) . Com- 
mands may be nested this way to a nesting depth of at least 
five, (If you use greater nesting depths than five, you run 
the risk of a type KX01 error.) 

SETUP Mod«* If the terminal is in SETUP mode, the <expand- 

macro> command does not take immediate effect. Instead, the 
macro definition is expanded later, when the terminal exits 
from SETUP mode. 



Defaults 



Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 None None Unchanged 



Errors 



KX01 (Level 2): The maximum nesting depth (for <expand~» 

macro) and <load> commands) has been 
exceeded. (The nesting depth should not 
exceed five. Greater nesting depths may re- 
sult - but do not necessarily result - in 
type KX01 errors.) 

KX02 (Level 3)° Out of memory while performing <expand- 

macro) command . 



KX11 (Level 2): Invalid macro identifier (must be in the 

range fr f om to 32767) . 



References 



<Def ine-macro> command 
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<Fill-Pattern-Definition> Syntactic Construct 4112, 4113 



SYNTAX 




<f ill-pattern- 


def inition> = <begin-f ill- patter n> 




[<pixel-def> . . . ] 




<end-f ill-pattern> . 


<pixel-def > = 


<runlength-wr ite> or <raster-wr ite> . 



Description 

To define a fill pattern ( for later use in filling panels) : 

1 . Issue a <beg in- f ill-pa ttern> command . 

2 . Issue several <raster-wr ite> and/or <runlength-wr ite> 
commands to specify the content of the fill pattern as 
an array of color-indices . 

3 . Issue an <end-f ill- patter n> command . 
References 

<Begin- fill-pa ttern> command . 
<End-fill-pattern> command . 
<Raster-write> command . 
<Runlength-write> command . 
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<Format-Volume> Command (Options 42 and 43) 



SETUP Mode Name: FORMAT 



SYNTAX 

<format-volume> = (ESC) ( J) (F) 

<str ing : device-name > 
<int : number-of-f iles> . 

PARAMETERS 

Device-Name, A <str ing> of the form "Fn: volume , !? in 
which n is the disk drive number ( or M and volume 
is a name being given the diskette for purposes of 
<dir ectory> commands . 

Number-of-Fllea (368 to 1 872) . Maximum number of files 
to be allowed on the disk volume . 



Description 

The < format- vol urn e> command formats a flexible diskette on 
the specified disk drive . Formatting includes verifying 
which areas of the disk are good and building a directory. 

If a previously formatted diskette is used (re-formatted) , 
any directories and files on that disk volume are wiped out 
and their space is used for the new directory . 

The string parameter takes the form "dev : volume" , where 
"dev :" specifies the disk drive ("FO:" or "F1 :") and "vol- 
ume" is a volume name which identifies the particular 
diskette in that disk drive. ( The volume name will appear in 
any directory of that diskette which may later be created by 
the <directory> command . ) The volume name can contain up to 
nine characters . 
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The <int> parameter specifies the number of files permitted 
in the diskette being formatted* (The number actually for- 
matted is a multiple of 16: the least multiple of 16 which 
is at least as large as the number specified in the <int> 
parameter . ) The <int> parameter should fall in the range 
from 368 to 1872. If less than 368 is specified, the disk 
volume is be formatted to hold 368 files. If more than 1872 
is specified, the disk volume is formatted to hold 1872 
files . 



The diskette being formatted must not be protected with a 
wr ite-protect notch . Also , the disk drive in which it is 
mounted must not be protected with the wr ite-protect switch . 
However , the < format- volume> command ignores any protection 
codes which may have been written on the diskette with the 
< protect- file> command . 

During the formatting , the terminal writes to the diskette 
and immediately reads what it has written . This detects any 
"bad blocks" (defective parts of the diskette surface) . If 
any such bad blocks are found , then the bad blocks are not 
recorded , and execution of the <format> command is 
terminated . In that case , the diskette is left unformatted , 
and a type JF 1 3 error occurs . 



Defaults 



Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 None None Error JF11 



None None 368 
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Errors 



JFOO (Level 2) 

JF10 (Level 2) 

JF11 (Level 2) 

JF12 (Level 3) 

JF13 (Level 2) 

JF19 (Level 2) 
References 



Unrecognized command 
installed . ) 



(Disk drive option not 



Device does not exist or is not installed. 

Invalid device specifier. 

Parameter 1 memory error. (Out of memory 
while parsing the device specifier string.) 

The device specified in parameter 1 (a) is 
not a disk drive, ( b) is write protected, 
(c) is busy, (d) detects a verify er*ror , or 
( e) detects a bit map error. 

Hardware error at the specified disk drive. 
(Format error, drive not ready, or write- 
protect switch or notch error.) 



< Protect- file> command 
<Directory> command . 
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(FS) Character 

See <enter-marker-mode> command. 
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<GIN-Locator-Report> 

NOTE 

Before reading this, see the description 
of <GIN-report-sequence> . 



SYNTAX 

<gin-locator-report> = <char-report : key> 

<xy-r eport : cur sor- posit ion> . 

PARTS OF THE REPORT 

Key. The ASCII character for the key which the opera- 
tor pressed to signal a GIN event . 

Cursor-Position. The position of the graphic cursor 
when the operator signalled a GIN event . 



Description 

When the terminal is enabled for a GIN (graphic input) 
locator function , the graphics cursor appears and the opera- 
tor moves the cursor (e.g. , with the thumbwheels) until it 
is positioned at a location which is to be reported to the 
host computer . Then the operator signals a "GIN locator 
event" (e.g., by pressing a keyboard key) . The terminal 
responds by sending a <GIN-locator-report> to the host . 

The <GIN-locator-report> is part of a larger sequence, the 
<GIN-report-sequence> , which includes all the GIN reports 
called for by a single <enable-GIN> command . 

Each <GIN-locator-report> is preceded by a signature charac- 
ter ; for details , see the descriptions of the <GIN-report- 
sequence) and the <set-report-sig-chars> command . 
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<Char-Report> • The <char-report> parameter is a single ASCII 
character : the character for the key which was pressed to 
signal the "GIN event . " If the thumbwheels were chosen as 
the GIN device in the preceding <enable-GIN> command , then 
this may be any ASCII character , since any ASCII character 
can be typed on the keyboard . 

If the GIN device is the tablet , then this character is ( M) 
if the tablet pen is used ; it is ( Z) if the one-button 
tablet cursor is used; and it is (Z) , (1), (2), or (3) if 
the four-button cursor is used . 

If the GIN device is an accessory plotter , then this 
character is always (0) or (1) : (1) if the pen is down , ( ) 
if the pen is up . 

<Xy-Report> • The <xy-report> parameter specifies the graphic 
cursor position ( in 4096 by 4096 "terminal space" 
coordinates) at the time that the operator signals the 
"locator event . " Its syntax is similar , but not identical , 
to the <xy> syntax used for sending terminal space coordi- 
nates to the terminal . For more information , see the <xy- 
report> syntax description . 



Ref erences 

<char-report> 
<enable-GIN> 
<GIN-report-sequence> 
<xy-report> 
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<GIN~Pick-Report> 

NOTE 

Before reading this, see the description 
of the <GIN-report-sequence> . " 



SYNTAX 

<gin-pick-report> = <char-report : key> 

<xy-report : cur sor-locat ion > 
<int-report : segment- numb er> 
<int-repprt : pick-i . J7^mimber > . 

PARTS OF THE REPORT 

Key. The ASCII character for the key which the opera- 
tor pressed to signal the pick event. 

Cursor-Location • The position of the graphic cursor at 
the moment of the pick event* 

Segments-Number • The segment number for the segment 
which the operator picked* 

Piok-X . D . -Number . The pick identification number for 
the part of the segment which the operator picked . 



Description 

When the terminal is enabled for a GIN (graphic input) pick 
function , the graphics cursor appears and the operator moves 
the cursor (e.g. , with the thumbwheels) until it is posi- 
tioned at a segment which the operator wishes to "pick . " The 
operator then signals a "pick event 11 (e.g. , by pressing a 
key) . The terminal responds by sending a <GIN-pick-report> 
to the host computer . This <GIN-pick-report> is part of a 
larger sequence , the <GIN-report-sequence> , which includes 
all the GIN reports called for by a single <enable-GIN> 
command . 
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When the operator signals a pick event , the terminal returns 
a <GIN-pick-report> to the host computer. This occurs 
regardless of whether there actually is a visible , detecta- 
ble segment within the current pick aperture. (If there is 
no such segment to be picked, the terminal returns zero as 
the segment number in the . ) 

If more than one visible, detectable segment falls within 
the pick aperture, the segment picked will be the one with 
the highest display priority. 

(For more details, see the descriptions of the <set-pick- 
ID> , < set- segment- v is ibility> , <set-segment-detectability> , 
<set-sur f ace-visibility> , <set-pick-aperture> , and <set-seg- 
ment-d ispl ay-priority > commands . ) 

Each <GIN-pick-report> is preceded by a "signature charac- 
ter ; " for details , see the descriptions of the <GIN-report- 
sequence> and the < set-report- si g-chars> command . 

<Char-Report> . The <char-report> parameter is a single ASCII 
character : the character for the key which was pressed to 
signal the "GIN event . " If the thumbwheels were chosen as 
the GIN device in the preceding <enable-GIN> command , then 
this may be any ASCII character , since any ASCII character 
can be typed on the keyboard . 

If the GIN device is the tablet , then this character is ( M) 
if the tablet pen is used ; it is ( Z) if the one-button 
tablet cursor is used ; and it is ( Z) , (1), (2), or (3) if 
the four-button tablet cursor is used . 

If the GIN device is an accessory plotter , then this 
character is always (0) or ( 1 ) . It is (1) if the pen is 
down , and (0) if the pen is up . 

<Xy-Rtport> • The <xy-report> parameter specifies the graphic 
cursor position ( in 4096 by 4096 "terminal space" 
coordinates) at the time that the operator signals the "pick 
event . " Its syntax is similar , but not identical , to the 
<xy> syntax used for sending terminal space coordinates to 
the terminal . For more information , see the <xy-report> 
syntax description , elsewhere in this section . 
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<Int-Report>s. The first <int-report> parameter gives the 
segment number of the segment being "picked." (If no visi- 
ble, detectable segment falls within the current pick aper- 
ture, this <int-report> parameter is 0.) 

The second < in t- report > gives the "pick identification num- 
ber" of a part of the segment within the pick aperture . If 
no visible , detectable segment falls within the pick 
aperture , then the pick-ID number in the <GIN-pick-report> 
is zero . 



References 

<char-report> 
<enable-GIN> 
<GIN-report-sequence> 
<int-report> 
<set-pick-ID> 
<set-pick-apertur e> 
<set-rep.ort-sig-char s> 
<xy-report> 
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<GIN-Report-Sequence> 



SYNTAX 

If only a single GIN device has been enabled, then the 
<GIN-report-sequence> sent to the host for that graph- 
ic input device has the following syntax: 

<GIN-report-sequence> = [ <GIN-report-item> . . . ] 

<f inal-GIN-report-item> . 

<GIN-report-item> = [ <eom-indicator> ] (Set Nofei 1#) 

[<sig-char>] (See Note 2. ) 
<GIN-rep.ort> 

[ <eom- indie ator> ] . (See Note 3«) 

<GIN-report> = <G I N-loca tor-re port> 
or <G I N- p ick- report > 
or <GIN- stroke- report> . 

<f inal-GIN-report-item> = [ <term-sig-char> ] (See Note 2. ) 

<eom-indicator> . 

Note 1 . This <eom-indicator> is sent only if both the 
following conditions are met : ( a) At least one charac- 
ter has already been sent on this line ( that is , since 
the last <eom-indicator> . (b) If the current line were 
not terminated (by sending this <eom-indicator> ) , then 
this <GIN-report-item> would cause the current maximum 
line length to be exceeded . 

Note 2. A signature character ( <sig-char> or <term- 
sig-char>) is sent only if that character is not 
(NUL) . 

Note 3 • An <eom-indicator> occurs at the end of each 
<GIN-report-item> only if the most recent <set-report- 
eom-f requency> command has specified that <eom-indica- 
tor>s are to be "more frequently" rather than "less 
frequently . " 
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Syntax Graphs 

The syntax just described is a little tricky; to make it 
easier to understand , it is repeated in Figure 4-5 as a 
series of "syntax graphs." 



Description 

A <GIN-report-sequence> is a sequence of reports which the 
terminal sends the host computer when enabled (by an 
<enable-GIN> command) for graphic input from a single GIN 
device . 

If more than one GIN device has been enabled, then the 
corresponding <GIN-report-sequence> s may be interleaved . 
That is , the <GIN-report-item>s and <f inal-GIN-report-item>s 
from the various enabled GIN devices may be intermixed . ( In 
that case , "signature characters" are used to distinguish 
the <GIN-report-item>s for one GIN device from the <GIN- 
report-item>s for another GIN device . ) 

When the terminal sends a report to the host , bypass mode is 
entered . ( See <enter-bypass-mode> . ) 

Overall syntax • The <GIN-report-sequence> from a single GIN 
device consists of a series of <GIN-report-itera>s , terminat- 
ed by a <f inal-GIN-report-item> . 

<QlN«Heport»ltem>S « The terminal sends a <GIN-report-item> 

each time a "GIN event" occurs. 

If the GIN device was enabled for the "locator" or "pick" 
functions then a GIN event occurs when the operator presses 
a keyboard key ( for the " thubwheels" GIN device) , presses 
the tablet pen or a button on the tablet cursor ( for the 
"tablet" GIN device) , or presses the appropriate button on 
the plotter ( for the "plotter" GIN device). 

If the GIN device was enabled for the "stroke" function, 
then a GIN event occurs each time a new coordinate is to be 
sent to the host computer. With the "stroke" function , this 
can happen many times a second. 
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<GIN— report— sequence > 



GIN— report—item 



7 



final— GIN— report— item 



<QIN— report — it em > 



EOM— indicator 



See Note 



1.1 



sig— char 



GIN— report 



See Note 2. 



i 



EOM— indicator 



See Note 3. 



t 



<GIN-»report> 



< 01 N - locator — report > 

_ — e> . — ~— — 



<GIN— pick— report > 



key pressed ^ 
< G I N «- stroke — report > 




GIN— locator — report 
GIN— pick— report 
GIN— stroke -report 




ASCII— character 



xy— report 



character for the key 
which was pressed 



cursor location 



1 





ASCII-char 


. _ . 


xy— report 




int— report 




int— report 















cursor position 



segment number 



pick— ID number 





ASCII-char 




xy— report 











key— pressed A cursor— location 



<finai™GIN-report-it®m> 





EOM— indicator 









3892-5 

Flfur« 4-3 » Syntax for a Sinilt <GIN-Report-Sequence> . 
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A typical <GIN-report-item> consists of a signature charac- 
ter, followed by a <GIN-report> . The <GIN-report> format 
depends on which GIN function was enabled; it is either 
<GIN-locator-report> , <GIN-pick-report> , or <GIN-stroke-re- 
port> . In addition, an <eom-indicator> (typically just the 
(CR) character) may be inserted at the start or end of the 
<GIN-report-item> . 

Signature Characters. The signature characters ( <sig-char> 
and <term-sig-char> ) are included for convenience when 
parsing the <GIN-report-sequence> . If two or more GIN de- 
vices are enabled at the same time , the signature characters 
serve to distinguish the <GIN-report-item>s ( and <f inal-GIN- 
report-item>s) coming from one GIN device from those coming 
f rom the other GIN device . 

Also , it is possible , even while GIN is enabled , to issue 
commands which cause the terminal to send a report to the 
host computer which is not part of the <GIN-report-se- 
quence> . For instance , even while GIN is enabled , a Report- 
terminal- set ting s> command can cause the terminal to send a 
<terminal-settings> report to the host computer . In that 
case , signature characters are used to distinguish the 
< terminal- set tings- report > from the <GIN-report-item>s in 
the <GIN-report-sequence>. 

The two signature characters ( < sig-char> and < term-sig- 
char>) are determined by the most recent <set-report-sig- 
char s> command for the particul ar GIN device-function code . 
For details , see the description of the <set-report-sig- 
chars> command . 

<GIN-Report>8. The <GIN-report> s for a single GIN device are 
all either <GIN-locator-report>s , <GIN-pick-report> s , or 
<GIN-stroke-report>s . The syntaxes of these are listed here 
as part of the syntax for the <GIN-report-sequence> . For 
more details, however , you should refer to the separate 
descriptions of the <GIN-locator-report>, <GIN-pick-report> , 
and <GIN-stroke-report> . 
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<EOM-Xndicator>s Within <GIN-Report-Item>s . The syntax for a 
<GIN-report-item> includes an optional <EOM-indicator> at 
the start of that item, and another optional <EOM-indicator> 
at the end of the item. 

The <EOM-indicator> syntax is described elsewhere in this 
section . If the terminal is not in block mode , then the 
<EOM-indicator> typically is just the ( CR) character . ( If 
the terminal is not in block mode , the <EOM-indicator> is 
just the current <EOL-string> , as set by the most recent 
<set-EOL-str ing> command . A typical <EOL-str ing> would con- 
sist of one character , (CR),) 

By issuing a < set-report- EOM- frequency : 1 > command , you can 
cause an <EOM-indicator> to be sent at. the end of each <GIN- 
report-item> . That way , each GIN-report-item is sent to the 
terminal as a single "line" of text ( if not in block mode) , 
or a single block ( if the terminal is in block mode) . This 
may be convenient for writing host routines to parse the 
<GIN-report-sequence>. 

However , you can also have the terminal fit several <GIN- 
report-item>s in the same line of text ( or in the same 
block , if using block mode) . To do this , choose the "less 
frequent" option in the < set- report- EOM- frequency> command . 
That is , issue a < set- report- EOM- frequency : 0> command . 
Also , choose a maximum line length ( with the <set-report- 
max-line-length> command ) which is sufficient to hold two or 
more <GIN-report-item>s . 

Under these circumstances , the optional <EOM-indicator> at 
the start of each <GIN-report-item> becomes important . If 
enough <GIN-r eport-i tem> s have been sent on the current 
line , so that even one more <GIN-report-item> would cause 
the maximum line length to be exceeded , then the terminal 
sends an <EOM-indicator> at the start of the next <GIN- 
report-item> . That <EOM-indicator> serves to terminate the 
current line , so that the maximum line length is not 
exceeded . The <sig-char> that follows would then be the 
first character of the next line . 
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<Final-GIN-Report-Xtem> . The terminal sends a <f inal-GIN- 

report-item> to the host computer when the graphic input 
function is disabled. This occurs when the <enable-GIN> 
command's "count" is exhausted , when the terminal receives a 
<disable-GIN> command , or when the operator presses the 
CANCEL key. The < f inal~GIN-report-item> consists of a <term- 
sig-char> , followed by an < EOM- indicator > . 

<T«rm-Sig-Char>. The <term-sig-char> is a single ASCII char- 
acter , which serves to notify the host that the <GIN-report- 
sequence> is ended . The < term-sig-char> , like the <sig-char> 
described earlier , is set by the <set-report-sig-chars> 
command . 

<Eom-Xndieator> in the <Final-GIN-Report-Sequence> . After 
the < term- sig- char > the terminal always sends an <EOM- 
indicator> . If the terminal is not in block mode , this is 
the current <EOL-string> ; typically it is ( CR) . If the 
terminal is in block mode , the <EOM-indicator> is sent by 
terminating the block and setting the block's end-of -message 
bit . 



References 

< EON- indie a tor > 
<Enable-GIN> 
<GIN-locator-report> 
<GIN~pick-report> 
<G IN- stroke- report> 
<Set-repor t-EOM-f requency> 
<Set-report-max-line-length> 
<Set-report-sig-char s> 
<set-EOL-str ing> 
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<GXN-Stroke-Report> 

NOTE 

Before reading this, see the description 
of the <GIN-report-sequence> . 



SYNTAX 

<G IN- stroke- report > = <char-report : key> 

<xy-report : cur sor-location> . 

where 

<char-report : key> = (M) or ( Z) or (1) or (2) or (3) 

for the first point in a stroke; 

<char-report : key> = (J) or ( SUB) 

for subsequent points in a stroke ; 

<char-report : key> = (0) or ( US) 

for the last point in a stroke . 

PARTS OF THE REPORT 

Key. For the first point in a stroke , the "key" 
character is ( M) if the operator uses a stylus , and 
( Z) , (1), (2), or (3) if a tablet cursor is used 
instead . Normally , subsequent points in a stroke are 
indicated with the letter (J), and the last point with 
the letter (0). However , these may be changed to the 
control characters (SYB) and (US) , respectively , by 
the < set- tab let-header- char s> command . 

Cursor-Location. The location of the graphic cursor 
f or one point of the stroke . 
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Description 

When an <enable-GIN> command has enabled the graphic tablet 
for the "stroke" function , the <GIN-report> s sent to the 
host in the <GIN-report-sequence> are <GI N- stroke- r eport> s . 
(In the <GIN-report-sequence> , each <G IN- stroke- re port> is 
preceded by a signature character; see the description of 
the <GIN-report-sequence> for details*) 

For each "stroke" that the operator performs at the tablet, 
many <GIN-stroke-repor t> s are sent to the host computer . 

First Point in the Stroke. The stroke begins when the 
operator presses the tablet pen against the tablet . If a 
one-button or four-button cursor is used instead of a pen , 
the stroke begins when the operator places the cursor on the 
tablet sur face and presses a button on the cursor . The 
terminal then sends the first <GI N- stroke- report> to the 
host computer . 

If the operator uses the tablet pen , then the <char-report : 
key> field in the < G IN- stroke- report > is the ASCII character 
(M)~. If the operator uses the optional four-button cursor , 
then the <char-report> field is (Z) , ( 1 ) , (2) , or (3) , 
depending on which cursor button is pressed . 

Subsequent Points . As the operator moves the stylus or 
cursor across the tablet , subsequent <GIN-stroke-report>s 
are sent . These report the positions through which the 
tablet pen or cursor moves . 

For each of these reports , the <char-report : key> field is 
either the ASCII character (J) or the ASCII control charac- 
ter , ( SUB) . The default is the letter ( J) ; however , this can 
be changed to (SUB) with the < se t- t ab let- header- char acters> 
command . 
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Last Point, The stroke ends (a) when the <enable-GIN> 
command's count expires, or (b) when the operator stops 
pressing the pen against the tablet , removes the cursor from 
the tablet surface , or releases the button on the cursor . 
The stroke also ends if the terminal's output buffer is 
filled up ; more about that later . 

If the stroke ends by the <enable-GIN> command 1 s count 
expiring , then the last point in the stroke is a valid data 
point like the ones that preceded it . In that case , the 
<GIN-stroke-report> for the last point uses the same <char- 
report : key > as for the preceding points : the letter (J) or 
the control character (SUB), as the case may be . 

If the stroke ends by an operator action ( such as removing 
the pen from presence) , it is possible that the last <xy- 
report> does not represent a valid coordinate . In that case , 
the final <GIN-stroke-report> includes a <char-report : key> 
field which is either the ASCII letter (0) or the ASCII 
control character , (US), The default is the letter ( 0) ; 
however , this can be changed to ( US) with the <set-tablet- 
he ad er- character s> command . 

This different <char-r epor t> - (0) or ( US) - serves to 
notify the host program that it should not rely on the 
accuracy of the associated <xy-report> . 

Filling Up the Output Buffer. It is easy, when using the 
stroke graphic input function , to digitize points faster 
than the terminal can send the corresponding <GIN-stroke- 
report>s to the host computer . When this happens , the 
terminal ' s output buffer can overflow. (You may be able to 
avoid this condition by using a high baud rate , or by using 
stroke filtering in order to digitize points less 
frequently . ) 

If the terminal 1 s output buffer is full , then the terminal 
can accept no more graphic input data until some of the 
characters in that buffer have been sent to the host 
computer . With the buffer full , attempting to enter more 
points ( a) causes the current stroke to end , and ( b) causes 
the terminal to sound its bell . The bell serves to warn the 
operator to pause before digitizing more points . ( The pause 
gives time for the terminal to transmit characters to the 
host , thereby freeing memory in the output buffer . ) 
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References 

<Char-repor t> 
<Enable-GIN> command • 
<Set-baud-r ates> command . 
<GIN-report-sequence> message type . 
<Set-GIN- stroke- filtering> command . 
< Se t- t ab 1 e t- he ad er- char acters> command . 
<Xy-report> 
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<Graphio-Text> Command 



SYNTAX 




<graphic-text> = (ESC) (L) (T) 

<string : text-to 


-be-displayed> . 


PARAMETERS 




Tex t-To-Be-Di splayed. A <string> 
characters in the range from (SP) 
equivalents in the range from 32 


containing ASCII 
to (~) - decimal 

to 126. 


Description 



The specified text string is drawn , starting at the current 
beam position • (More precisely , the lower left corner of the 
first graphtext character's character cell is positioned at 
the current beam position . ) The beam is updated to the lower 
left corner of the character envelope of the next character 
position past the last character written . 

The string is drawn in the current graphtext font, as 
determined by the most recent < set- graph text- font > command . 
If no graphtext font has been selected , then font zero is 
used . 

Table 4-12 lists the predefined graphext fonts . If a key- 
board option is installed , then all these fonts are avail- 
able ; however , font zero remains the default f ont . If no 
keyboard option is installed , then only font zero is prede- 
f ined . 
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Table 4-12 

GRAPHTEXT FONTS AVAILABLE WITH KEYBOARD OPTIONS 



Font Number 


Graphtext Font 





Standard ASCII 


1 


Swedish 


3 


United Kingdom 


7 


APL 


9 


Danish/ Norwegian 



Any characters in the current font which have not been user- 
defined are displayed as the corresponding character in the 
predefined font with the same font number* (In all 
terminals , font (the ASCII font) is predefined . Terminals 
equipped with optional keyboards also have fonts 1,3, 7 , and 
9 predefined . ) If there is no predefined font with the same 
font number , then the corresponding character of font is 
used . 

If "stroke precision" is used ( the default in the absence of 
a <set-graphtext-precision> command) , then the graphtext is 
drawn as a series of vectors . Its appearance is governed by 
the most recent <set-text-index>, <set-graphtext-size>, 
< set- graph text- font > , and <set-graphtext-rotation> commands . 

If the most recent <set-graphtext-precision> command speci- 
fied "string precision , " then the graphtext is displayed as 
if it were alphatext . In that case, the <set-graphtext- 
font> , <set-graphtext-size> , and <set-graphtext-rotation> 
commands have no effect . Instead , the graphtext appearance 
is governed by the most recent <set-text-index> , <set- 
alphatext-size>, and < set- alpha text- font > commands . 
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If the graphtext string is too long to fit within 4096-by- 
4096 terminal space, then the 4112 does not display the 
portions of characters which extend outside of terminal 
space. (They are "clipped" at the boundary of terminal 
space . ) In the 4114, if any part of a graphtext character 
extends outside of terminal space , then that character is 
not displayed . 

Graphtext is not allowed within a . That is , the <graphic- 
text> command is not allowed between a < beg in- pan el- bound ay> 
command and the following <end-panel> command . If you do 
issue a <gr aphic-text> command within a <panel-definition>, 
the terminal detects a type LT03 error . 



Defaults 



Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 None None Empty string 



Errors 



LT03 (Level 2): Command is invalid at this time . (Graphtext 

is not allowed within a <p an el-def initio n>. 



LT1 1 (Level 2): Invalid graphtext string . Invalid array 

count ( must be in range from to 32767), or 
invalid <char> character in the array (must 
be in the range from ( SP) to (~) - decimal 
equivalents from 32 to 1 26 ) . 



LT12 (Level 3 ) : Parameter 1 memory error . ( Out of memory 

while parsing the <string> parameter . ) 
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References 

<Set-graphtext-siz£> command . 
<Set-graphtext-rotation> command . 
<Set-graphtext-precision> command . 
<Set-graphtext«=font-gr id> command . 
<Set-graphtext-font> command. 
<Begin-graphtext.-character> command . 
<End^graphtext-character>- command. 
<Set-text-index> command. 
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(GS) Character 

See <enter-vector-mode> command. 
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<Hardcopy> Command 



SYNTAX 

<hardcopy> s (ESC) (K) (H) 

<inti hard-copy-code> . 

PARAMETERS 

H«rd~Copy-Cod« CO through 2)# Selects the type of 

hardcopy operation that is genereated with respect to 
the type generated by the HARD COPY key. 

= Same as the HARD COPY key for all terminals. 

1 = Same as the HARD COPY key for the 4112 and 4113. 

Same as the Shifted HARD COPY key for the 4114. 

2 = Same as the HARD COPY key for the 4114. 

Same as the Shifted HARD COPY key for the 4112 and 
for the 4113 if Option 9 is not installed , or if 
Option 9 is installed and the standard hardcopy 
interface is selected . 

If Option 9 is installed on a 4113, and the color 
hardcopy interface is selected, this code causes a 
black/ white inversion . 



Description 

This command generates a hardcopy if there is the proper 
type of hardcopy machine attached to the terminal 1 s hardcopy 
interface* 4112 terminals and 4113 terminals without Option 
9 installed require a TEKTRONIX 4612 or 4632 Video Hard Copy 
Unit, and 4114 terminals require a TEKTRONIX 461 1 or 4631 
Hard Copy Unit. 

If you are using a 4113 with Option 9 (the color hard copy 
interface) installed, this command generates a hardcopy on 
the unit attached to the interface selected by the Select- 
hardcopy- inter face> command . The color hard copy interface 
requires that a TEKTRONIX 4691 Color Graphics Copier be 
attached for proper operation* 
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During a hard copy , operation of the display is suspended . 

Other activity is allowed, but any display activity is 
queued until the hard copy operation is finished . 

H1 12# On a 41 12, if the hard copy code is or 1 , the action 
is the same as the HARD COPY key on the keyboard. A hard 
copy is made in such a way that white lines on the display 
appear as black lines on the hard copy . 

If the hard copy code is 2, the action is the same as the 
SHIFT-HARDCOPY key* A hard copy is made in such a way that 
white lines (on a black background) on the display appear 
also as white lines on a black background on the hard copy 
(video inversion) . (If no hard copy unit is attached, the 
<hardcopy : 2> causes the screen to 11 flash. 11 ) 

4l13«This command is the same on the 4113 as on the 4112, 
unless Option 9 is installed and the <select-hardcopy- 
inter face> command has been set to the color hardcopy 
interface. If this is the case, <hardcopy : 2> causes a 
black/white inversion instead of a video inversion. 

41 14. On a 4 1 14, if the hard copy code is or 2 , the action 
is the same as the HARD COPY key on the keyboard . A hard 
copy is made on that hard copy unit . Objects displayed in 
refresh mode are "fixed" (drawn once in storage mode) before 
the copy is made, so they may appear on the copy . 

If the hard copy code is 1 , the action is the SHIFT-HARDCOPY 
key on the keyboard . A hard copy is made • Objects displayed 
in refresh mode are not fixed before the copy operation ; 
consequently, they do not appear on the hard copy. 

<4010-Hardeopy> Comand . The 4110 includes a <4010-hardcopy> 
command for compatibility with host software written for 
earlier TEKTRONIX terminals: 



The <4010-hardcopy> command is equivalent to a <hardcopy : 0> 
command 

Defaults 



<4010-hardcopy> = (ESC) (ETB) 



Faraaatar 

Nuabar 



As Ship pad 

From Factory 



On Po war-Up 



If tha Paraaatar 

is Gaittad 



1 



None 



None 
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Errors 



KH01 (Level 2): Copier fault condition; operator assistance 

required (Option 9 only) . 

KH11 (Level 2): Invalid hardcopy code (must be f 1 f or 2). 

References 

<401 0-hardcopy> command . 
HARDCOPY Key. 

<Select-hardcopy-inter f ace> command * 
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HARD COPY Key 



Description 

Pressing the HARD COPY key initiates a hard copy operation . 
This requires that a TEKTRONIX 4631 or 4611 Hard Copy Unit, 
a TEKTRONIX 4632 or 4612 Video Hard Copy Unit, or a color 
hardcopy unit , if you are using a 4113 with Option 9 
installed , is attached to the appropriate hardcopy interface 
on the back of the terminal . 

During a hard copy , operation of the d isplay is suspended . 
Other activity is allowed , but any d ispl ay activ ity is 
queued until the hard copy operation is finished • 

41 12. On a 4112 pressing HARD COPY causes a hardcopy to be 
made using the usual convention for hardcopies : lines which 
appear on the screen as white lines on a black background 
appear on the hardcopy as black 1 ines on a white background • 
Thus alphatext , which is normally displayed "white on black" 
appears on the hard copy paper as "black on white" - the 
customary fo rmat for displaying pr int on paper. On a 4113, 
the "inverted color" is the result of subtracting th_ 
original color from bright white . 

Pressing SHIFT-HARD COPY causes a hardcopy to be made using 
the^ opposite convention : lines which appear on the screen as 
white on a black background appear also on the hard copy as 
white on a black background (video inversion) . 
If no hard copy unit is attached , SHIFT-HARD COPY causes the 
screen to "flash." 
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4113. Pressing this key (both shifted and unshifted) causes 
the same operations on the 41 13 as on the 4112, unless 
Option 9 is installed and the < select-hardcopy-inter face> 
command has been set to the color hardcopy interface. If 
this is the case , a color hard copy is generated (provided 
the 4691 Color Graphics Copier is attached) when the HARD 
COPY key is pressed . If the SHIFT-HARD COPY key is pressed , 
a color hardcopy is generated with black and white inerted 
using color ( instead of using video) . 

H114. With a 4114, in order that objects displayed in 
refresh mode may appear on the hard copy, all such objects 
(segments in refresh mode, and text in the dialog area) are 
"fixed" on the screen - drawn once in storage mode . The 
segment attributes are not changed , however : after th. hard 
copy, you can press PAGE to erase the screen , and any 
refresh mode objects will again appear in refresh mode. 

Pressing SHIFT-HARD COPY copies only objects drawn in stor- 
age mode; objects displayed in refresh mode are not fixed on 
the screen . 

The HARD COPY and SHIFT-HARD COPY keys do not auto-repeat. 



References 
<Hardcopy> command . 

<Select-hardcopy-interface> command . 
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(HT) Character 



Description 

Alpha Modi, When the terminal is in alpha mode and it 
receives an ASCII (HT) "horizontal tab" character, the alpha 
cursor moves on character position to the right . (The 
terminal does not have internal tab stops . ) 



On a 4114, if the alpha cursor is at the right edge of the 
screen, a (HT) character - like a (SP) character - causes 
the cursor to move down one line and to the left edge of the 
current margin • 

On a 4112 or 4113, if the alpha cursor is at the right edge 
of the 4096-by-4096 terminal space, then a (HT) character 
moves the cursor to the start of the next line in terminal 
space . 

Marker and Vector Modes. When the terminal is in marker mode 
or vector mode , the (HT) character has no effect . 

References 

<Enter-alpha-mode> command . 
< En ter-vec tor-mod e> command . 
<Enter~marker-mode> command . 
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<Ignore-Deletes> 



SETUP Mode Name: IGNOREDEL 



SYNTAX 




< ignor e-deletes> = 


(ESCMO(I) 

<int : ignor e-deletes-mode> . 


PARAMETERS 




Ignor s-Beletes-Mode 

(DEL) characters* 1 


(0 or 1). = NO; do not ignore 
= YES; do ignore (DEL) s. 


Description 



If the < int> parameter is one , the terminal will ignore any 
(DEL) (or "RUB OUT") characters which it receives . ( In that 
case , in sending < int> , < int+> , or < xy> parameters to the 
terminal , the host should substitute (ESC) (?) for any (DEL) 
characters it would otherwise send . ) 



If the < int> parameter is zero , the terminal will respond 
properly to any ( DEL) characters which it receives . 



Defaults 

P§f affltter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

10 



4110 SERIES COMMAND REFERENCE REV, DEC 1981 



4-175 



ALPHABETICAL LISTING 



Error s 



K 1 1 1 (Level 2) : Invalid ignor e-del et es mode (must be or 

1 ) . 

References 

<Delete-equiv alent> syntactic construct, 
<Int> and <int+> parameter types. 
<Xy> parameter type. 
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<Inoluda-Copy«of-Segment> Command 



SYNTAX 

<include-copy-of-segment> = (ESC) (L) (K) 

< int : segment -number> . 

PARAMETERS 

Segment-Number (~3 f -1 , or 1 to 32767) . Specifies the 

segment to be included. Minus three means "all seg- 
ments in the current matching class." Minus one means 
"all segments." 



Description 

Encountering this command between a <begin- segment> command 
and an < end- segment> command causes the following to occur: 

ft The current segment attributes are saved. (These are: 
the current graphic beam po sition , 1 ine style , 1 ine 
index, text index, marker type, and pick ID. In the 
4114, these also include the current . alpha text size 
and line width.) 

# The designated segment (scaled, rotated, and posi- 
tioned according to its current image transform param- 
eters) is copied into the segment being defined. 

. The attributes that were saved are restored. 

If no segment is currently being defined, the segment 
designated in the < include- copy-of-segment> command is drawn 
on the screen according to its current image transform. 
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Defaults 

Parameter 

Number 

1 

Errors 



As Shipped 
From Factory 

None 



On Power-Up 



None 



( 



If the Parameter 
is Omitted 

Error LK11 



LK02 (Level 3): Out of memory while performing < include- 

copy-of-segment> . 

LK10 (Level 2 ) : Segment does not exist. 

LK11 (Level 2): Invalid segment number (must be -3 , -1 , or 

in the range from 1 to 32767.) 

LK1 3 (Level 2): The segment specified is currently being 

defined . 

References 



<End-segment> command 



( 
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<Int> and <Int+> Parameter Type 



SYNTAX 




<int> = 


[<HiI> [<HiI>] ] <LoI> . 


< int+> 


= [<HiI> [<HiI>] ] <LoI> . 


<LoI> = 


(an ASCII character whose numeric equivalent 
is in the range from 32 to 53 : a character 
whose most- significant bits are "01") . 


<HiI> = 


( an ASCII character who se numeric equivalent 
is in the range from 54 to 1 27 - except that 
(ESC) ( ?) may be used as a substitute for 
(DEL) , character number 127) . 



Description 

Integer numbers are sent to the terminal in a packed format , 
as < int> or < int+> parameters . 

As far as their syntax is concerned , these two parameter 
types are identical . The < int+> ( pronounced " int plus" ) 
parameter type differs from the < int> parameter type only in 
the valid range of numbers which may be sent . <Int> 
parameters represent numbers in the range from -32763 to 
+ 32767 , while <int+> parameters represent number s in the 
range from to +55535 . 
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NOTE 



If your host computer has a word size 
which is larger than sixteen binary 
bits , then you need make no distinction 
between <int> and <int+> parameter 
types . In that case , a single subroutine 
oan serve to send both <int> and <int+> 
parameters to the terminal . 

If, however , your host computer has six- 
teen-bit words , then the distinction be- 
tween <int> and <int+> parameters be- 
comes important . <Int> parameters 
represent integers which can be stored, 
using two's complement binary format , in 
a single 16-bit computer word . <Int+> 
parameters , on the other hand , can be 
stored in a 16-bit word only by using an 
unsigned binary integer format . 



Examples . The coding scheme is devised so that numbers from 
-15 to +15 may be sent as a single character; for integers 
from to 9 , the < int> parameter is just the single ASCII 
character for that digit : 



<int 
<int 
<int 
<int 
<int 

< int 
<int 
<int 
<int 

< int 
<int 

< int 

< int 
<int 
<int 

< int 



0> = 
1> = 
2> = 

3> = 
4> = 

5> = 

6> = 

7> = 

S> = 

9> = 

10> 

11> 

12> 

13> 

14> 

15> 



(0) 
(1 ) 
(2) 

(3) 
(4) 
(5) 
(5) 
(7) 
(3) 
(9) 
(:) 

(;) 
(<) 
( = ) 
(>) 
(?) 



<int 
<int 
<int 
<int 
<int 
<int 
<int 
<int 
<int 

< int 

< int 
<int 
<int 

< int 
<int 



-1> = (!) 

-2> = ('*) 

-3> = (#) 

-4> = ($) 

-5> = (%) 

-6> = (&) 

-7> = (*) 



-S> = ("(") 
-9> = (")") 



-10> = (*) 

-1 1 > = (+) 

-12> = ( ,) 

-13> = (-) 

-14> = ( .) 

-15> = (/) 
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For numbers with absolute values greater than 1 5 , the 
corresponding < int> (and < int+> ) parameters consist of more 
than one character. For examples, see Appendix B . 

Explanation . The < int> or < int+> parameter consists of zero , 
one, or two <HiI> characters, followed by one <LoI> charac- 
ter . The <LoI> character holds the sign bit and the least- 
significant four data bits for the ?t sign-magitude" binary 
representation of the integer. The <HiI> characters need 
only be sent if the integer is large enough to require more 
than four data bits and a sign bit; these <HiI> characters 
each hold six data bits. 

<L©1> Chsrtsttr « The <LoI> character (omitting the parity 
bit) has this format: 

1 s d d d d 

Here, s is the sign bit: it is 1 for positive integers, and 
for negative integers. The bits "dddd" are the least- 
significant bits in the binary numeral representing the 
magnitude of the integer. 

<H1I> Characters. The <HiI> characters have this format: 

1 d d d d d d 

Here, "dddddd" represent six of the more- significant bits in 
the binary numeral representing the magnitude of the inte- 
ger . 

Faoklng Procedure • To represent a number in the range from 
-32763 to +65535 as an <int> or < int+> parameter, do the 
following : 

1. Determine the sign of the number. If it is positive, 
the " s" bit in the <LoI> character is 1 . If it is 
negative, that bit is 0. (For < int+> parameters, 
negative numbers are not allowed.) 
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2. Take the magnitude (absolute value) of the number, and 
represent it as a binary numeral . The least-signifi- 
cant four bits of this binary numeral are the "dddd" 
bits in the <LoI> character. 

3 . The next least-significant six bits in the binary 
numeral are the "dddddd" bits in the <HiI> character 
which will precede the <LoI> character . 

4 . The most-significant six bits in the binary numeral 
are the "dddddd" bits in the < H i I > character which 
precedes the other <HiI> character . If all this bits 
are zero , then this character need not be sent . If all 
data bits in both < H i I > characters are zero , then both 
<HiI> characters may be omitted . 



PASCAL Example* Figure 4-6 shows a PASCAL routine which 
might be used to send < int> or < int+> parameters to the 
terminal . (This routine assumes a host computer whose word 
size is more than sixteen bits; if your host computer has a 
1 6-bit word size, then the routine will only work for 
issuing <int> parameters , and the IntType ? s range must be 
restricted : from -32768 to +32767 . ) In the example , the 
procedure Send Ascii , given an integer in the range from to 
1 27 , sends the corresponding ASCII character to the 
terminal . ) 
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PROCEDURE Sendlntd : IntType); 

{* Encodes I as a sequence of bytes in the <int> format and * 

{ * sends those bytes to the terminal. * 

{* Calls the SendASCII procedure, which sends a single ASCII * 

{* character to the terminal. Also uses the following globally- * 

{* declared data type: * 

{ * * 

{* TYPE * 

{* IntType = -32768 .. +32767 ; * 

{* SevenBitType = 0. . 127; * 

j * * 
{*ft****ft»ft**ft«****ft*****fttt**«**ft***ft**tt**ft***^ 

{} CONST { 

{} MaxNumberBytes = 3; {*** I should be in the range from } { 

{} { -32768 to +32767, so no more than } { 

{} {three bytes are needed. »**} { 

{ } VAR { 

{} StackPoin ter , J : 0. . Max Number Bytes ; { 

{} Stack : ARRAY[ 1 Max Number Bytes] OF SevenBitType; { 

{} Hil : 64. .127; ( 

{} Lol : 32. .63; { 

{} Negative : BOOLEAN; { 

{} PROCEDURE Push(Byte : SevenBitType); {** Push byte on stack **} { 

{ } {}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}(}{}{}{}{}{}{}{} ( 

{} {} BEGIN {} { 

{} {} StackPointer := StackPointer +1; {} { 

{} {} Stack[StackPointer ] := Byte O { 

{} {} END; {} { 

{} {}{}{}{}{}{}{}{]{}{){}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}(}{}{}{}{} { 

{} BEGIN {*** statement-part of Sendlnt procedure *** } { 

{} { *** Initialize things. *** } { 

{} StackPointer := 0; { 

{ } Negative := FALSE; { 

{} { *** Compute bytes, push them onto the stack. ***} { 

{} IF I < { 

{ } THEN BEGIN { 

{ } I : = -I ; { 

{ } Negative : = TRUE ; { 

{} END; { 

{} { *** Compute Lol byte, push it on the stack. *** } { 

{} {*** <LoI> : binary Olsdddd; s = sign bit, d = data bit .***}{ 

{} { *** s= 1 for positive numbers, s=0 for negative numbers. **}{ 

{ } Lol := I MOD 16 + 32; ( 

{} IF NOT Negative THEN Lol := Lol + 16; { 

{} Push(LoI); { 

{ } I : = I DIV 16; { 

{ } { *** Compute Hil bytes, push them on stack. *** } { 

{} {*** <HiI> : binary Iddddd. ***} { 

{ } WHILE I > ( 

{ } DO BEGIN t 

{ } Hil := (I MOD 64) + 64; { 

{} Push(Hil); { 

{ } I : = I DIV 64 { 

{} END; { 

{} { *** Pop bytes off stack and send them to the terminal. ***} { 

{} FOR J := StackPointer DOWNTO 1 { 

{} DO Send ASCII (Stack[ J ] ) { 

{} END; {*** of Sendlnt procedure *** } { 
{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{ 
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FORTRAN Example* Figure 4-7 is a translation of the preced- 
ing example into FORTRAN, Here, the subroutine SENDCH plays 
the role of the procedure Send Ascii in Figure 4-6, 

Control Characters. Ignored . Within and parameters, ASCII 
control characters are ignored. These are the characters 
with decimal equivalents in the range from to 31 . For 
instance, the terminal ignores any (CR) and (LF) characters 
which it may encounter while parsing an <int> or < int+> 
parameter . 

However, the (ESC), (US), (GS) , and (FS) characters are 
exceptions. These are the characters which cause a command 
to be terminated early . (For details, see " Commands of Three 
or More Characters , ?t in Section 2 . ) When the terminal 
encounters an (ESC) , (US), (GS) , or (FS) character within an 
<int> or < int+> parameter, it terminates both the <int> or 
<int+> parameter and the command of which that parameter is 
a part. 



References 

< Arr ay> parameter types, 
<Real> parameter type. 
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SUBROUTINE SENDIN(N) 
LOGICAL NEGTIV 

INTEGER HII1 , HII2, LOI, TEMPN 

C To avoid altering N, copy into the variable TEMPN 
TEMPN = N 

NEGTIV = (TEMPN . LT . 0) 
IF ( .NOT. NEGTIV) GOTO 1 
C If sign is negative ... 

TEMPN = -TEMPN 

LOI = (TEMPN - (TEMPN/1 6)*1 6) + 32 
GOTO 2 
C If sign is positive 

1 LOI = (TEMPN - (TEMPN/16)*16) + 48 

TEMPN = TEMPN/16 

2 IF (TEMPN . LE. 63) GOTO 3 

C If TEMPN >= 64, we send <Hi 1 1 XHi I2XLo I> 

HII2 = (TEMPN - (TEMPN/64)*64 ) + 64 

HII1 = TEMPN/64 + 64 

CALL SENDCH(HIH) 

CALL SENDCH(HII2) 

CALL SENDCH(LOI) 

GOTO 10 
C Else , if TEMPN <= 63 

3 IF (TEMPN . EQ. 0) GOTO 4 

C If < TEMPN <= 63 , we send <Hi I2XLoI>. . . 
HII2 = TEMPN + 64 
CALL SENDCH(HII2) 
CALL SENDCH(LOI) 
GOTO 10 

C If TEMPN r 0, we send only the <LoI> character . . . 

4 CALL SENDCH(LOI) 

10 RETURN 
END 
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<Int-Report> Parameter Type 



SYNTAX 



<int-repor t> 



[<EOM-indicator>] 
<Hi I-repor t> 
<Hi I-repor t> 
<LoI-repor t> . 



(See note*) 



<Hi I-repor t> 



(an ASCII character whose numeric 
equivalent is in the range from 32 to 
95) . 



<LoI-report> 



(an ASCII character whose numeric 
equivalent is in the range from 32 to 
53) . 



Note . The <eom-indicator> is rarely included in the 
< int-repor t> . The terminal only sends this <eom-indi- 
cator> if there is no other way to avoid exceed ing the 
current maximum 1 ine length . See the description for 
details . 



Description 

When the terminal has occasion to send integer numbers to 
the host computer , it sends those numbers packed in the 
< int-repor t> format . ( This may happen , for example , in 
response to any of a variety of M inquiry" commands : 
<repor t- terminal- statu s> , < report- segment- status> , <repor t- 
error-status> , etc . ; or as part of a <GIN-pick-repor t> in 
response to an < enable-GIN> command . ) 

The host computer sends integers to the terminal using the 
<int> (or < int+> ) syntax . The terminal sends integers to 
the host using the < int-repor t> syntax . These two formats 
are similar , but not identical : 
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• The < int-repor t> may include an <EOM-indicator> to 
terminate a "line" of data being sent to the host . 
(The <EOM-ind icator> will be sent if not sending it 
would cause the current max imum line length to be 
exceeded.) When parsing an < int-repor t> , provision 
must be made for coping with this <EOM-ind icator> . 

♦ Unl ike < int> and <int+> parameters , < int-repor t> s al- 
ways have three characters . 

« The packing scheme for an < int-repor t> 1 s <LoI-report> 
character is identical to that for an <int> ? s <LoI> 
character . 

9 The packing scheme for an < int-repor t> f s two <HiI- 
report> characters uses a d if f erent "offset" than for 
an <int> f s two <HiI> characters . In an < int> 1 s <HiI> 
character , 64 is added to a six-bit binary numeral to 
form the ASCII decimal equivalent of the <HiI> charac- 
ter . In an < int-repor t> f s <Hi I-repor t> character , 32 
(rather than 54) is added to the six-bit binary 
numeral . 
details . ) 

<EOM-Indicator> . The optional <EOM-ind icator> , if sent in 
the < int-repor t> , will always be the terminal 1 s current 
<EOL-str ing> . This <EOM-ind icator> is rarely sent . The 
reason for this is that an < int-repor t> is always part of 
some larger report message , and the syntax of that 1 arger 
report generally makes provision ( with its own <EOM-indica- 
tor> s) for terminating lines before the max imum line length 
is exceeded . 

However , if the max imum report 1 ine length is set too short , 
then it is possible that optional <EOM-ind icator> s in the 
syntax of the 1 arger report would not cause the line to 
terminate soon enough . Only in that case would the optional 
<EOM-indicator> in the < int-repor t> syntax come into play . 
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Parsing an <Int-Report> . A general-purpose routine for pars- 
ing < int-repor t> s should take into account the optional 
<EOM-indicator> . 

Since this <EOM-ind icator> will only be sent if the terminal 
is not in block mode, and in that case the <EOM-indicator> 
is just the current <EOL-str ing> , the parsing routine should 
be able to distinguish the current <EOL-str ing> from valid 
<Hi I-repor t> and <LoI-repor t> characters. 

This is easiest to do if the <EOL-str ing> consists only of 
control characters , such as ( CR) and (LF) . In that case, the 
parsing routine can just skip over any such control charac- 
ters . Figure 4-S shows an example . 



Reference s 

<Int> and < int+> parameter types . 

< Set-max -report- line- length> command . 
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PROP FHflR F Pflr^pfinTnf RpnnrWVAR N • T WTFHFR ^ • 




T YPF 




A DFTvnp - 1 ? 7 • | ASCII decimal eauivalents * * 1 




VAR 




ADE • ADETvoe 9 




Fir st Hi I , SecondHi I , Lol : 0. . 63 ; 




Negative 8 BOOLEAN ' 




BEGIN 




{ ** Skip past any control characters * * } 




REPEAT 




Rec e i v e Asc i i ( ADE ) 




UNTIL CADE > 3?) e 




FirstHil : = ADE - ^2 • 




{ * * Accept second <Hi I~repo r t> * * } 




ReceiveAscii f ADF ) • 




SecondHil : r ADE - 32; 




{ ** Accept the <LoI-repor t> ** } 




ReceiveAsc ii( ADE) ; 




Lol : = ADE - 32; 




{** Examine the sign bit in the <LoI-report> ** } 




Negative : = (Lol < 16); 




{ ** Compose the number N ** } 




IF NOT Negative 




THEN Lol : = Lol - 16; 




N := Lol + l6*SecondHiI + 1 024*Fir stHi I ; 




IF Negative 




THEN N := -N 




END; of Par se An In t Report procedure ** } 






3892-8 



Figure 4-8. Parsing an <Int-Report> in PASCAL. 
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<Int-Array-Report> Parameter Type 

See "<Array-Report> Parameter Types." 
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<Key-Execute-Charaoter> 

The <key-execute-char acter> is a single ASCII character, 
determined by the < set-ke y- execute- char act er> command. When 
a macro numbered from to 143 is invoked by pressing the 
corresponding key, the <key-execute-char acter> delimits 
those character s which are to be executed locally by the 
terminal , and not sent to the host computer . The <key- 
ex ecute- char act er> serves only as a delimiter ; it is neither 
executed locally nor sent to the host computer . 

The < key-execute-char acter> only has its special ef f ect when 
a macro is invoked by pressing a key . If a macro is invoked 
with the <expand-macro> command , any < ke y- ex ecute- char ac- 
ter> s within it are treated just 1 ike other characters in 
the macro definition . 



References 

<Def ine-macr o> command . 
<Expand-macro> command . 
<Set-key-execute-char acter> command . 
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(LF) Character 



Description 

Vector and Marker Modes . The (LF) character has no effect 
when the terminal is in vector mode or marker mode - unless 
"LF-implies-CR" is in effect. (If "LF-implies-CR" is in 
effect, then the terminal behaves as if it had received a 
(CR) character after the (LF) character. If the dialog area 
is disabled, so that the terminal emulates TEKTRONIX 401 0- 
series terminals, the implied (CR) puts the terminal in 
alpha mode . ) 

4114 Alpha Mode, Dialog Area Disabled . In the 4114, if the 
dialog area is d isabled , then (LF ) moves the alpha cur sor 
down one 1 ine ; the graphic beam position is updated to the 
lower left corner of the alpha cur sor . (The amount of this 
vertical movement is determined by the most recent < set- 
alphatex t-si ze> command . ) If mov ing the alpha cursor down 
one line would pi ace its lower left corner off the screen , 
then one of several things may happen : 

. If a segment is currently being defined , then nothing 
happens ; the (LF) character has no effect . 

If no segment is being defined , the alpha cursor moves 
to the top of the screen , at the next margin . If the 
current margin is the last margin ( the Nth margin if N 
margins are defined ) , then a page-full cond ition oc- 
curs. What happens next depends on the most recent 
<se t~ page- full-action > command . See the description of 
the < set-page- full-action> command for details. 

4112 and 4113 Alpha Mode, Dialog Area Disabled. In the 4112 
and 4113 terminals , if the area is d isabled , then (LF ) moves 
the alpha cur sor down one line in terminal space . (The size 
of this motion in terminal space depends on the current 
window- viewport transform . It is the distance in terminal 
space which corresponds to mov ing downward by 1 4 pixels in 
raster memory space . ) 
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If no segment is being defined, and moving the alpha cursor 
down one line would place it outside the 4096-by-4096 
terminal space, then a "page full" condition occurs. What 
happens next depends on the most recent <set-page-full- 
ac tion> command ; see the description of that command for 
details . 

If a segment is currently being defined , and moving the 
alpha cur sor down one 1 ine would place it outside of 
terminal space , then the (LF) character has no effect . 

Alpha Mode, Dialog Area Enabled . On any 41 1 series 
terminal , if the d ialog area is enabled , then (LF) moves the 
cur sor down one 1 ine in the d ialog area . 

The raster- scan terminals (4112, 4113) include a special 
prov ision to avoid d ispl aying double 1 ine feeds when a (LF) 
or ( CR ) (LF ) occur s just after the cur sor has wrapped around 
to the start of a new 1 ine . ( In that case,, the (LF ) 
immediately after the wrap-around is not d ispl ayed . ) 

If the "LF-implies-CR" mode is in effect , the cur sor al so 
moves to the beginning of the 1 ine , and the terminal enters 
alpha mode , just as if a (CR) character had been received . 
See the <LFCR> command description for details . 



References 

<LFCR> command . 
<Set-margins> command . 
<Set-alphatex t- si ze> command . 
<Set-page- full- act ion > command . 
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<LFCR> Command 



SETUP Mode Name: LFCR 



SYNTAX 

<lfcr> 



(ESC) (K)(F) 
<int: LFCR-mode> 



PARAMETERS 

LFCR -mod 6 (0 or 1)* 1 = YES; line-feeds are processed 
as (LF) ( CR) sequences, = NO; turns off LFCR process- 
ing. 



Descr iption 

If the <int> parameter is one , each line feed received is 
processed as a line feed followed by a carriage return. 

If the LINE-FEED key on the terminal keyboard is pressed, 
the generated carriage return is not sent to the host • 

If the <int> parameter is zero , this feature is turned off. 



Defaul ts 

ftr unettr 

Number 

1 



As Shipped 

From Factory 





On Power »Up 

Remembered 



If the Parameter 
is Omitted 





Error s 

KF11 (Level 2): Invalid LFCR mode (must be or 1), 
References 



<CRLF> command 
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<load> Command (Options 42 and 43) 



SETUP Mode Name: LOAD 



SYNTAX 

<load> = (ESC) (J)(L) 

< string: file-specif ier > . 

PARAMETERS 

Pllt-SptOlf iff '• Names the disk file to be executed as 
a command file. 



Description 

Causes the file specified by "dev : filename" to be executed 
as a command file, just as if the host had transmitted the 
file contents to the terminal . 

The file to be < load> ed may contain <load> and <expand- 
macro> commands . However , the nesting of such commands 
should not exceed five. (Greater nesting depths may result - 
but do not necessarity result - in type KX01 errors.) 

Keyboard data entered during file execution are queued until 
execution is completed. An execution may be aborted by 
pressing the CANCEL key. 
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Defaults 

Number 

1 

Error s 



As Shipped 
From Factory 

None ;; 



On Power-Up 



None 



c 



If the Parameter 
is Omitted 

Error JL11 



JL02 (Level 3) 

JL03 (Level 2) 

JL10 (Level 2) 

JL1 1 (Level 2) 

JL12 (Level 3) 

JL13 (Level 2): 

JL19 (Level 2): 
References 
<Save> Command 



Out of memory while performing <load> 
command. 

Nesting error. (<Load> commands are nested 
too deeply . ) 

File or device does not exist. 
Invalid file specifier. 

Parameter 1 memory error, (Out of memory 
while parsing parameter 1 , or while execut- 
ing the command,) 

Context error in parameter 1 . (Not a valid 
source device,) 

Disk hardware error or drive not ready. 



( 



c 



4-196 



REV, dec 1981 4110 SERIES COMMAND REFERENCE 



ALPHABETICAL LISTING 



LOCAL Key 



Descr ipt ion 

Pressing the LOCAL key once "causes the terminal to enter 
local mode and turns on the light in the key. Pressing the 
key again turns off the light and removes the terminal from 
local mode. 

When the terminal is in local mode (that is, when the light 
in the LOCAL key is on) , the terminal does not respond to 
characters coming from the host. Instead, it stores these 
characters in the "communications queue 11 part of its memory 
- at least, until that part of its memory is exhausted. (The 
communications queue can be made larger - or smaller - by 
means of the < set-queue- si ze> command.) 

Also, while the terminal is in local mode, characters typed 
on the keyboard are not sent to the host computer. Instead, 
they are displayed on the screen. Escape sequence commands 
typed on the keyboard will be obeyed as if they had come 
from the host computer. 

Setup mode over-rides local mode; that is, if both the SETUP 
and LOCAL lights are on, the terminal is in setup mode, not 
local mode. 

The LOCAL key does not auto-repeat. 
References 

<Set-queue- si ze> command. 
SETUP key. 
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<lOGk-Keyboard> Command 



SETUP Mode Name: LOCKKEYBOARD 



SYNTAX 

<lock-keyboard> = (ESC) (K) (L) 

< int : locking-mode< . 

PARAMETERS 

Looking-Mode (0 or 1). = NO; unlocks the keyboard . 1 
= YES; locks the keyboard . 



Descr ipt ion 

The < lock-keyboard> command lets the host computer disable 
the keyboard keys . (This is useful at times when a host 
computer program cannot tolerate input from the operator . ) 

To lock the keyboard , send the following command : 

<lock-keyboard : 1 > 

= (ESC) (K) (LXint : 1> 
= (ESC)(K)(L)(1) . 

When the keyboard is locked , the KYBD LOCK lamp is on , and 
all keys in the basic keyset , except the CANCEL key , are 
inoperative . 

The keyboard can be unlocked by issuing a <keyboard-lock> 
command in which the < int> parameter is zero . It can al so be 
unlocked by pressing the CANCEL key , or issuing a < cancel> 
command . 
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Defaults 



P§f ameter 
Number 



As Shipped 
From Factory 



On Power-Up 



If the Parameter 

is Omitted 



o 



Remembered 







Error s 



KL11 (Level 2): Invalid keyboard-lock mode (must be or 1). 

References 

CANCEL key. 

<Cancel> command. 

< Lock-vie wing-keys> command. 



4110 SERIES COMMAND REFERENCE REV.DEC1981 4-199 



ALPHABETICAL LISTING 



<look-Viewing-Keys> Command 4112, 4113 



Syntax 


SYNTAX 




<look-viewing-keys> = (ESC)(R)(J) 

< int : locking-mode> . 




PARAMETERS 




lOOking-Mode (0 or 1), = NO; unlocks the 

keys . 1 = YES; locks the viewing keys . 


viewing 


Descr ipt ion 




This command is available only in the 4112 and 
nal s . 


4113 termi- 


The < lock-vie wing-keys> command lets the host program dis- 
able the terminal f s four v iewing keys . These are the four 



keys clustered together just to the left of the thumbwheels : 
ZOOM, PAN, VIEW, NEXTVIEW ( and their SHIFTed versions, 
NORMAL, OVERVIEW, RESTORE, and BORDER) . 

The < lock- vie wing-keys : 0> command - (ESC) (R) ( J) (0) - allows 
the four grouped keys to be used . 

The <lock-viewing-keys : 1 > command - (ESC) (R) (J ) ( 1 ) - has 
the following effects : 

. If the terminal is in framing mode ( that is , if the 
light on the ZOOM key or the PAN key is turned on) , 
then the terminal is removed from framing mode , just 
as if the operator had pressed the lighted key . 

# The four framing keys are d isabled in the same way 
that the <keyboard-lock : 1 > command d isables the 
entire keyboard . While these keys are d isabled , press- 
ing them only sounds the bell and has no other effect . 
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The host computer can inquire whether the viewing keys are 
locked by issuing a <repor t- term in al- setting s> command for 
the !! R J" op code . The < terminal- sett ings-report> sent in 
response to such a command not only tells the host whether 
the viewing keys are locked, but also reports whether the 
terminal is in ZOOM or PAN submode of framing mode. For 
details, see the description of the < terminal- setting s- 
repor t> message type. 



Defaults 



P§fiffl«t#r As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 



Error s 



RJOO (Level 0): Unrecognized command . ( The terminal is not a 

4112 or a 4113.) 

RJ11 (Level 2): Invalid locking mode parameter (must be or 

1). 

References 

<Lock-keyboard> command . 

<Report- terminal- sett ings> command . 

<Terminal- setting s-report> message type . 
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<Map-Index-to-Pen> Command (Option 10) 



SETUP Mode Name: PMAP 



Syntax 



SYNTAX 

<map- index- to- pen> = (ESC) (P) (I) 

< string: port- ident if ier> 

< int : index- to- be-mappecT> 

< int : pen-ID-number> . 

PARAMETERS 

Port-Identifier ("P0: ,f , "P1:% or "P2:") . Specifies 
the RS-232 peripheral port for which color- indices are 
to be mapped to plotter pen numbers . 

Index-To-Be-Mapped (-1 to 255) . Values from to 255 
specif y a par ticul ar color- index . Minus one means " all 
color- ind ices . f! 

Pen-ID-Number (0 to N) . N is the maximum number of 
pens for the plotter assigned to the port . Values from 
1 to N name particul ar plotter pens . "Pen zero" means 
"no pen . " 



Descri ption 

This command assigns a 3pecific color- index to a particul ar 
plotter pen number at the specified peripheral port . When 
graphic data is drawn on the plotter at that port , all with 
that color-index will be drawn using the specified pen . 

Peripheral Port Identifier. The peripheral port identifier 
is a < str ing> parameter identifying the peripheral port to 
which the plotter is connected . This < str ing> may be " P : " , 
"P1 :" , or "P2:" . 
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Index to be Mapped • The first < int> parameter specifies the 
color-index which is to be assigned to the particular 
plotter pen. If this parameter is -1 , it means that all 
color- ind ices are assigned to that pen. 

Fill 10 Number* The second <int> parameter specifies to which 
pen the color-index is to be assigned. Values of 1 to N name 
a particul ar plotter pen . Here , N is the max imum number of 
pens for the plotter in question . For a standard 4562 
plotter , N = 1 . For a 4652 equipped with Option 31, N = 3. 
For a 4663 plotter, N = 2. 

Pen number zero means "no pens . " For example , selecting 
index 2 and pen zero causes color-index 2 to be assigned to 
no pen . (Lines drawn in color- index 2 will not be plotted . ) . 

Assigning a color- index to one pen automatically deletes 
that color- index from any other pen to which it may previ- 
ously have been assigned . 



Examples 



<map- index- to- pen : " P : " , -1 , 0> Use no pens . 
< map- index- to- pen : " P : " , -1, 3> Map all indices to pen 



number 3 . 



<map- index-to-pen 



!f P0:% 5, 0> 



Do not draw color- index 
5 . ( color- index 5 is 



not assigned to any of 
the pens at peripheral 
port zero . ) 



<map- index- to- pen 



"P0: ft , 5, 2> 



color- index 5 is as- 
signed to pen number 2 
at peripheral port ze- 
ro . ) 
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Defaults 

Parameter 
Number 

1 

2 
3 

Error s 



As Shipped 
.From Factory 

None 

None 

None 



On Power-Up 

None 

None 
None 



If the Parameter 
is Omitted 

Error PI1 1 






PI00 (Level 0): Unrecognized command, (Option 10 is not 

installed) . 

PI02 (Level 3): No memory is available for the index map . 

(To guarantee an available index map for a 
particular peripheral port , the <map- index- 
to-pen> command should be issued immediately 
after power-up , or immediately after a <re~ 
set> command . ) 



PI1 1 (Level 2) 



Invalid port identifier (must be "P0 : " , 11 P 1 
or "P2:") . 



P1 1 2 (Level 2): Parameter 1 memory error . ( Out of memory 

while parsing the port name string . ) 



P1 1 3 (Level 2) 

PI21 (Level 2) 

PI31 (Level 2) 
References 



Port busy . 

Invalid index (must be in the range from -1 

to +255) 

Invalid pen number (must be in the range 
from to 255) . 



<Plot> command . 
<Set-line-index> command . 
< Set- text- index> command . 
<Set-sur f ace- gray- lev el s> command . 



4-204 



rev, DEC 1981 4110 SERIES COMMAND REFERENCE 



ALPHABETICAL LISTING 



<Move> Command 


SYNTAX 




<move> = (ESC) (I) (F) 

<xy: position> . 




PARAMETERS 




Position (X a to 4095 f Y ■ 

in terminal space to which the 


to 4095) . The position 
graphic beam is moved™ 



Description 

The (move) command moves the graphic beam position to the 
point in terminal space specified by the command's <xy> 
parameter . 

The effect of the <move> command is like that of the 
following sequence: 

< enter- vector -mod e> <xy> 
= (GS)<xy> 

However, unlike a (GS)<xy> sequence, the (move) command does 
not affect the terminal's operating mode. If the terminal 
was in alpha mode before executing a (move) command, then it 
is in alpha mode after the (move). If the terminal was in 
marker mode before a (move) command, then it is marker mode 
after the move. 



Defaults 

Pififllifctf As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 None None ' (0,0) 
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Error s 

No errors are detected for this command. 
Ref er ences 

< En t er - vector -mod e> command . 
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NEXTVIEW Key 4112, 4113 



Description 

The NEXTVIEW key exists only in the 4112 and the 4113- It 
does not auto-repeat. 

This key is useful only when multiple views have been 
defined ( by means of <select-view> commands) . Pressing 
NEXTVIEW saves the status of the current view and selects 
the next higher-numbered view. Pressing NEXTVIEW while hold- 
ing the CTRL key down selects the next lower-numbered view. 
The selected view's border is blinked once . 

If the terminal is in " frame mode," ( that is , if the light 
in the PAN key or the ZOOM key is on) , then pressing 
NEXTVIEW does not alter the location of the framing box - 
the "proposed new window" - in terminal space) . 



References 

<Select-view> command . 

PAN key. 
ZOOM key. 
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NORMAL Key 4112, 4113 



Description ; 

The NORMAL key (the SHIFTed version of the ZOOM key) exists 
only in the 4112 and the 4113. 

This key has effect only when the terminal is in ■ tf framing 
mode , " that ; . is, when the framing box is displayed and the 
light on the ZOOM key or the PAN key is turned on . 

Pressing the NORMAL key adjusts the shape of the framing box 
( the "proposed new window" ) so that is the same shape ( the 
same ratio of width to height) as the original window for 
that view. 

Here , "original window" means the window defined by the most 
recent <set-window> command for that view. ( The operator's 
manipulation of the viewing keys does not count . ) If no such 
<set-window> command has been issued , then the original 
window is the window in effect when the view was created . 

This key does not auto-repeat . 



References 
command . 

<Set-window> command . 
ZOOM key. 
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OVERVIEW Key 4112, 4113 



Description 

The OVERVIEW key exists only in the 4112 and the 4113- It 
does not auto-repeat . 

OVERVIEW Key. Pressing the OVERVIEW key (the SHIFTed version 
of the PAN key) causes the following to occur : 

• The current view's viewport is erased . 

» The factory def ault window is selected ( that is , f rom 
X = to X = 4095, and from Y = to Y = 3127) . If the 
CTRL key is pressed together with OVERVIEW, then the 
"full universe" window is selected (that is, from x=0 
to x = 4095 , and from y=0 to y=4095) . 

9 If the terminal is in " framing mode" ( that is , if the 
PAN key light or the ZOOM key light is on) , the 
terminal remains in framing mode and the framing box 
showing the "proposed new window" remains at the same 
position in terminal space . 

CTRL-OVERVIEW Key. Pressing CTRL-OVERVIEW (pressing the PAN 
key while holding down the SHIFT and CTRL keys) has an 
effect similar to that of the OVERVIEW key . However , instead 
of selecting the factory default window, CTRL-OVERVIEW se- 
lects a window which covers all of terminal space : from X = 
to X = 4095, and from Y = to Y = 4095. 

If ftot of View Display Clusters, in the 4113, it is possible 
to group several views together in a "view display cluster . " 
(See the description of the <set-view-display-cluster> com- 
mand for details . ) If this is done , then pressing OVERVIEW 
or CTRL-OVERVIEW affects not only the current view, but also 
all other views in the same display cluster as the current 
view. 
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References 

The description of the OVERVIEW key in the terminal's 
Operator's Manual . 

<Set-v.iew-display-cluster> command . 
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<Page> Command 



SYNTAX 

<page> = (ESO(FF) . 



Description 

The effect of the <page> command depends on whether the 
dialog area is enabled. 

If the Dialog Area is Enabled. If the dialog area is 
enabled ? the <page> command (or pressing the PAGE key) 
erases the current view and redraws any visible segments. In 
the 4114, the entire screen is erased, and all visible 
segments are redrawn. In the 4112, only the viewport for the 
current view is erased , and only segments visible in that 
view are redrawn . 

If the Dialog Area is Disabled. With the dialog area 
disabled , the terminal emulates earlier TEKTRONIX terminals 
which lack a dialog area . As before , the current view is 
erased and all visible segments are redrawn . In addition , 
the following actions occur : 

1* The current line style is reset to line style zero 
( solid lines) . 

2. The effect of any <enable-40 1 0-GIN> command is 
cancelled . ( That is , the terminal exits 401 0-style GIN 
mode . ) 

3 . In the 4114, the current margin is reset to margin 
one . 

4. The graphic beam position ( and the alpha cursor) is 
moved to the point at X=0, Y=3071. 
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5. The terminal enters alpha mode. In the 4112, the lower 
left corner of the alpha cursor - and the graphic beam 
position - moves downward by an amount equal to the 
height of ope alphatext character. Thus, in the 4112, 
the cursor Is no longer exactly at the point (0 ,3071 ) . 

6 • Any escape-sequence being entered from the keyboard or 
the host host computer is cancelled, i.e., not execut- 
ed. (SETUP mode commands are not affected by the PAGE 
key . ) 



Ref erences 

<En able- dial og-area> command . 
PAGE key. 
<Renew> command . 
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PAGE Key 

Description 

Pressing the PAGE key has the same effect as issuing a 
<page> command . This key does not auto-repeat. 

References 
<Page> command . 
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MN Key 4112, 4113 



Description 

The PAN key exists only in the 4112 and the 4113. It does 
not auto-repeat. 

If the light in the PAN key is not on, pressing this key 
turns on that light and puts the terminal in " frame mode , " 
in the "pan submode . " (If the terminal is already in "frame 
mode" - that is , if the light in the ZOOM key is on - then 
the terminal stays in frame mode , but leaves the " zoom 
submode" and enters the "pan submode.") 

While in PAN submode , the terminal displays a " framing box" 
with a cross in its center . (The cross 1 s vertical line is 
0.2 of the framing box f s height ; the cross 1 s horizontal line 
is . 2 of the framing box's width . ) This framing box 
indicates the boundary of a "proposed new window" in termi- 
nal space . ( To put the proposed new window into effect , the 
operator would press the VIEW key . ) 

While in pan submode of frame mode , moving the thumbhweels 
causes the proposed new window to move about in terminal 
space ; the framing box moves too , to show the location of 
the proposed new window. Moving the horizontal thumbwheel 
moves the framing box to the right or left ; moving the 
vertical thumbwheel moves it up or down. 

To exit framing mode , press the PAN key again ; the light on 
the key will turn off, and the terminal will exit framing 
mode . To leave PAN submode and enter ZOOM submode , press the 
ZOOM key; the PAN key light will turn off, and the ZOOM key 
light will turn on . 



References 
ZOOM key. 
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«Panel-Definition> Syntactic Construct 4112, 4113 



SYNTAX 

<panel-def inition> = < p ane 1- bound ar y-de fin it ion> 
[ < pan el -bound ary-de fin it ion> . . . ] 
<end-panel> . 

< panel-bound ar y-de fin it ion> = <beg in- panel -bound ary> 
[ <boundary-point> . . . ] . 

< bound ary-point> = <xy> (See note. ) 

or (GS)<xy> 
or (FSXxy> 
or <move> 
or <draw> 
or <marker> . 

Nott. An <xy> is valid here only if the terminal has 
already been placed in vector mode or marker mode • 



Description 

To draw a panel : 

1. Before the <panel-def inition> , send a <set-panel- 
f illing-mode> command to specify whether the panel 
boundary is to be drawn , and how ( and whether) its 
interior is to be filled . 

2 . Send a < beg i n- pan el- bound ary> command to the terminal . 
This begins the <panel-def init ion> . The graphic beam 
position moves to the position specified by the <be- 

g i n- pan el - boundary > command , just as if a (GS) 
character ( <enter-vector-mode> command ) had been sent . 
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3 . If the terminal is not already in vector mode , send it 
an < enter- vector- mod e> command - the (GS) character . 
This prepares the terminal so that it may correctly 
interpret < xy> parameters as the coord inates of ver- 
tices of the panel boundary . 

4 . Send a series of <xy> par ameter s to specify the 
vertices of the panel boundary . (In pi ace of <xy> 
parameters , you may use <move> , <draw>, or <marker> 
command s . ) 

5 . Send an < end-panel> command . 



Considerations in <Panel-Def inition> s 

Within a < panel- bound ary-definition>, the < bound ary- point s> 
can be specified by <move> , <draw> , or <draw-mar ker> com- 
mand s , all of which have <xy> par ameter s . Or , a boundary 
point can be spec if ied by an <xy> parameter which is not 
part of another command - but only if the terminal is in 
vector mode or marker mode . (If the terminal is in alpha 
mode , it does not interpret <xy> parameters correctly , but 
displays them as alphatex t . Moreover, if the d ialog area is 
not enabled , this alphatex t causes the panel definition to 
be terminated , as if an <end-panel> command were received . ) 

If you wish , you can intersperse (GS ) and ( FS ) characters 
( <enter- vector- mod e> and < en ter- marker- mod e> command s) among 
the <xy> coord inates within a <panel- bound ary-de fin it ion> . 
These serve to guarantee that the terminal is not in alpha 
mode . 

Except for that guarantee , however , the panel boundary is 
unaffected by (GS) and (FS) characters interspersed among 
the < xy> coordinates • If the panel boundary is drawn at all , 
all of its edges are drawn , regardless of any interspersed 
(GS ) character . No markers are drawn at the vertices of the 
boundary , regardless of any interspersed ( FS ) characters . 

Gr aphtex t , like alphatex t , is not permitted within a <panel- 
def inition> . If a panel is being defined when a <graphic- 
tex t> command is received , an error is detected and the 
panel definition is terminated . 
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After the <end-panel> command, the terminal is in vector 
mode, marker mode, or alpha mode, according to which of 
these modes it was last placed. (It is, of course, bad 
practice to put the terminal in alpha mode within a <panel- 
def init ion> . ) The graphic beam position is updated to the 
point specified by the <xy> parameter in the last <begin- 
panel-boundary> command . 

References 

<Begin-panel> command . 
<End-panel> command. 
<Set-f ill-pat tern> command . 
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<Pixtl-Copy> Command 4112, 4113 



Syntax 



SYNTAX 

<pixel-copy> = (ESC) (R) (X) 

<int : d estination-- surface > 

<xy : destinat ion- lower- left-corner > 

<xy : f ir st- source- corner > 
<xy : "secolT?^^r c e ^coFne r > * 

PARAMETERS 

Dtitinatlon-Surfaoe (4112s -1 to 3; 4113: -1 to 4). 

Names the surface to which pixels are to be copied . 
Minus one specifies a " super surface" consisting of 
all bit planes on all surfaces which have been de- 
fined* 

Destination-Lower-Left-Corner (X s to 639, Y s to 
479) • Names the lower-left corner of the region on the 
destination surface to which pixels are to be copied . 

First-Source-Corner (X = to 639, Y = to 479) . One 

corner of a rectangular region on the current pixel 
surface . The pixel at this corner is copied to the 
lower-left corner of the destination region . 

Seoond-Source-Corner (X a to 639, Y = to 479). The 

corner opposite the first- source-corner in the 
" source" rectangular region . 



Description 

The <pixel-copy> command copies pixels from a rectangular 
region on the current pixel surface in raster memory space 
to a rectangular region (of the same dimensions) elsewhere 
in raster memory space . 
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Here , " the current pixel sur face" means the sur face speci- 
fied in the most recent < begin-pixel-oper at ion s> command. 
Pixels are copied to the destination region using the ALU 
mode specified in the most recent < begin-pixel-oper at ion s> 

command . 

In this command, all <xy> coordinates specify pixel 
positions in 640-by-480 raster memory space • 

Destination Surface. The first parameter , of parameter type 
< int> , spec if ies to which writing sur face the pixels are to 
be copied . The spec ial sur face number -1 designates a " super 
sur face" consisting of all bit planes of all sur faces 
currently defined . ( Be sure to read Append ix D, "Bit Planes 
and Sur faces , " if you will be using the super sur face . ) 

Destination Lower Left Corner . The second <xy> parameters 
spec if ies the lower left corner of a rectangular r eg ion on 
the destination surface in raster memory space . (This desti- 
nation region is the same width and height as the source 
region specified by the next two <xy> parameters . ) 

Source Corners . The last two < xy> parameters are opposite 
corners of a rec tangul ar region on the current pixel sur- 
face . The <pixel-copy> command copies each pixel in thi s 
rec tangul ar region onto a correspond ing pixel in the desti- 
nation region on the destination sur face ( or on all 
sur faces , if the destination sur face number is - 1 . ) 

The two " source corners" need not be the lower left and 
upper r ight corner s , respectively , of the source r eg ion . 
However , if they are not , then a "mirror" or "inversion" 
operation is performed when copying . That is, the pixels 
wr itten to the destination region may form a mirror image , 
or an inverted image , of the picture formed by the pixels in 
the source region . The pixel at the first source corner is 
copied onto the pixel at the lower left corner of the 
destination region . The pixel at the second source corner is 
copied onto the pixel at the upper right corner of the 
destination region . 

If the <pixel-copy> operation is to the same location on the 
same sur face , then it is not performed . 
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Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 



1 


None 


None 





2 


None 


None 


(0,0) 


3 


None 


None 


(0,0) 


4 


None 


None 


(0,0) 



Errors 



RX00 (Level 0): Unrecognized command. (The terminal is not a 

41 12 or a 41 13. 

RX10 (Level 2): The specified destination surface does not 

exist . 

RX11 (Level 2): Invalid destination surface. (In the 4112, 

must be in the range from -1 to 3; in the 
4113, must be in the range from -1 to 4 . ) 

RX21 (Level 2): Invalid destination-lower-left-corner. (X 

must be in the range from to 639, and Y 
must be in the range from to 479.) 

RX3 1 (Level 2): Invalid first-source-corner. (Same range as 

for the destination-lower-left-corner.) 

RX41 (Level 2): Invalid second- source- corner . ( Same range as 

f or the dest in at ion-lower- left- corner and 

the first-source-corner.) 
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<Fixtl-Def> Syntactic Construct 4112, 4113 



SYNTAX 

<pixel-def > = <raster-wr ite> or <runlength-wr ite> . 



Description 

When sending color-indices to the pixel viewport , or when 
sending them into a fill pattern definition , you may use 
both <raster-wr ite> and <runlength-wr ite> commands . The 
<pixel-def > syntactic construct is just a way of expressing 
this f act ; it is used in the syntax definition for <f ill- 
pat tern-def in it ion> . 



References 

<Begin-fill-pattern> command . 
<Begin-pixel-operations> command . 
<End-fill-pattern> command . 

<Fill-pattern-definition> syntactic construct . 
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<Plot>- Command (Option TO) 



SETUP Mode Name: PLOT 



SYNTAX ... . 

<plot> = (ESC) (P)(L) 

<str ing : separ ator-str ing > 
< st ring: output- spec if ier> . 

PARAMETERS 

Separator-String (Empty String or w TO tf )r 

Output-Speoif ier • Specifies the destination for the 
<plot> . May be a peripheral port to which a plotter 
driver has been <port-assigned> (e.g. , " P : " ) . May 
also be a disk file ( "FO: FILENAME" ) or the host 
computer ( "HO: " ) . 



Description 

The <plot> command takes currently visible segments , con- 
verts them into "escape sequence" commands , and sends them 
to the specified output device . 

4114. In the 4114, all currently visible segments are sent 
to the destination device • 

4112, 4113. In the 4112 and 4113, only those segments - or 
parts of segments - within the current view's window are 
sent to the output device . In addition to the segment 
definitions ( and segment attributes) , <set-window> and <set- 
viewport> commands are sent , so that the output device 
"knows" the location of the view 1 s window and viewport . 
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If the output device is a peripheral port, and the most 
recent <port-assign> command has assigned a plotter protocol 
to that port, then the terminal sends "plotter language" 
escape sequences to the destination port. (See the descrip- 
tion of the <port-assign> command for details,) Otherwise, 
the terminal sends 41 1 0-series escape-sequence commands to 
the destination device . 



©Utput DiViOt. The output device specifier may be any of the 
following <string> parameters: 

<string : "PO : "> Specifies RS-232 peripheral port zero . 

If a <port-assign> command has assigned 
a plotter protocol to peripheral port 
zero , then the visible segments are 
converted into escape-sequence commands 
for the TEKTRONIX 4662 or 4663 Interac- 
tive Digital Plotter ; those plotter 
commands are then sent to peripheral 
port zero . In this process , all segment 
position information is taken into ac- 
count , and all markers are converted 
into "moves" and "draws . " 



If the peripheral port does not have a 
plotter protocol assigned to it , then 
the visible segments are converted into 
commands for the 4 1 1 X terminal . 

<str ing : " P 1 : " > Same as above , but for peripheral port 

one . 

<str ing : "P2: "> Same as above , but for peripheral port 

two . 
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<string : "FO : f ilename"> or 
< string : " f ilename" > or 
<string : "F1 : f ilename"> 

Specifies a file on the 4110 f s flexible 
disk drive* (If the drive number is 
omitted, drive zero is assumed; the 
filename is always required*) The visi- 
ble segments (in the current view on a 
4112) are converted to 4110 commands , 
and those commands are stored on the 
disk file. (Thus, the current view or 
the. display on the screen can be re- 
created by <load>ing the disk file*) 

<string : "HO: "> Specifies the host computer . The 

visible segments are converted to 4110 
commands , and those commands are sent 
to the host computer. (When doing this , 
the host computer 1 s echo should be 
turned off.) The terminal terminates 
the transmission with an end-of-f ile 
string, just as during a <copy> to the 
host computer. (The host computer can 
be instructed to save these commands. 
Then, to recreate a view, or a display 
on the screen, the computer would send 
those commands back to the terminal.) 

Window-VttwpQrt Traniform (4112 f: 4113). in. the 4112 and 
4113, only the part of the picture within the current window 
is plotted. (This is. the part of the current view which is 
visible in that view's viewport . ) Lines passing through the 
window boundaries are properly clipped. (Thus, if the output 
device is a peripheral port with a plotter attached, the 
plotter pen is not driven off the paper.) If multiple views 
exist, only the current view' s segments are sent to the 
output device. 
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NOTE 

When a view is drawn on a plotter in 
response to the <plot> command, segments 
may appear at slightly different loca- 
tions that when those same segments are 
drawn with the <save> command. This is 
because the <plot> command includes 
<set«window> and <set-viewport> commands 
in the data being sent to the peripheral 
port , while the <save> command does not. 

T© make segments to appear the same when 
<plot>ted as when <save>d,-you should 
set the view 1 s window to extend from 
(0 f 0) to (4095,3071 ) in terminal space 

and its viewport to extend from (0 f 0) to 
(4095 f 3071 ) in normalized screen coordi- 
nates,, 



Selecting Plotter Pens. If the output device is a peripheral 
port with a plotter protocol assigned , then any <set-line- 
index> commands within the segments cause the corresponding 
plotter pen to be used when drawing subsequent graphics . 
Likewise , any <set~text-index> commands cause the corres- 
ponding pen to be used for subsequent alphatext . ( The 
"corresponding pen" is determined by the most recent <map- 
index-to-pen> command . ) 

Transfers To The Host. If the destination device for the 
<plot> command is the host computer , then the terminal 
inserts <EOM-indicator>s into the data it sends to the host * 
An <EOM-indicator> is inserted after every N characters of 
data , where N is the maximum line length set by the <set- 
report-max-line-length> command . (The <EOM-indicator s> serve 
to break the data into "lines of text" of a size which the 
host computer can handle . This feature can be disabled by 
setting the maximum line length to zero . ) Also , the terminal 
appends the current <E0F-str ing> to the end of the data 
being sent . (The <EOF-string> is set by the <set-EOF-str ing> 
command . ) 
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Transfers T© Peripheral Ports. If the destination device for 
the <plot> command is an RS-232 peripheral port, and a 
plotter device protocol has not been <port-assign>ed to that 
port, the terminal appends that port's end-of-file string to 
the end of the data being transferred. (Normally, of course, 
<plot> ■ command's to a port to which a plotter is attached and 
a plotter device protocol is <port-assign>ed . ) 



Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 None None Error PL 1 1 

2 None None Error PL21 



Errors 



PLOO (Level 0) 

PL11 (Level 2) 

PL12 (Level 3) 

PL20 (Level 2) 



PL21 (Level 2) 

PL22 (Level 3) 
PL23 (Level 2) 



Unrecognized command . ( Option 10 is not 
installed . ) 

Invalid first parameter . ( Must be the empty- 
string or "TO 11 . ) 

Parameter 1 memory error . ( Out of memory 
while parsing the <str ing> parameter . ) 

Non-existent destination device (if destina- 
tion specifier is of the form "F0 : filename" 
or "F1 : filename" , then the corresponding 
disk drive must be installed . ) 



Invalid output specifier ( must be "HO: " , 
"P0:" , "P1 :" , "P2:", "F0 : filename" or "F1 : 
filename" ) . 



Parameter 2 memory error . (Out of memory 
while parsing the destination <str ing> . ) 

Parameter 2 context error . ( Invalid destina- 
tion device , or device is busy . ) 



( 
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References 

<Copy> command . 

< Map-index-to- pen > command . 

command . 

<Set-EOF-string> command . 
<Set-line-index> command . 
command. 

<Set-report-max-l ine-length> command , 
<Set-text-index> command . 
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<Port-Assign> Command (Option 10) 



SETUP Mode Name: PASSIGN 



SYNTAX 

<port-assign> = (ESC)(P)(A) 

<string: port- id en ti f ier> 

<str ing : protocolary . 

PARAMETERS 

Port-Identifier ( ff P0s% " P 1 s ff , or fS P2s ff ) « Specifies 
the RS-232 peripheral port to which a protocol is 
being assigned. 

Protocol-Identifier . A <str ing> specifying the proto- 
col being assigned to the peripheral port. Valid 
values are "PPORT," "4643," "4662," "4662/MP," 
"4662/NT," "4663," "4663/NT," and "4663/NB," 



Description 

The <port-assign> command assigns a "device protocol" to a 
particular RS-232 peripheral port . ( This command requires 
that Option 10 , the Three Port Peripheral Interface , be 
installed in the terminal . ) 

The command has two parameters : the port identifier and the 
protocol identifier* 

Port Identifier. The port identifier is a three-character 
<str ing> parameter : "P0 : " for peripheral port 0, " P 1 : " for 
peripheral port 1 , or "P2: " for peripheral port 2 . These 
identify the three RS-232 peripheral connectors on the rear 
panel of the terminal . 

Protocol Identifier, The protocol identifier , another 
<str ing> parameter , specifies the communications protocol 
which the terminal will use in communicating with a peri- 
pheral device connected at the specified peripheral port. 
Table 4-13 lists the valid protocol identifiers . 
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Table 4-13 
PERIPHERAL PORT PROTOCOL IDENTIFIERS 



Protocol 


Identifier 

Meaning 


PPORT 


Assigns a general-purpose RS-232 communi- 
cations protocol (a protocol that makes no 
assumptions about the nature of the at- 
tached device) . When data is transferred 
to this port , the end of the data is 
marked by appending the port ? s end-of-f ile 
string , as set by the <set-port-EOF- 
str ing> command . 


4643 


(4643 Printer) • Assigns a communications 
protocol which is suitable for a TEKTRONIX 
4643 Printer . Any ( CR) characters sent to 
this port will be replaced by the port's 
current end-of-line string , as set by the 
<set-port-EOL-str ing> command . As with the 
PPORT protocol , the end of a data transfer 
is marked with the port's end-of-f ile 
string . 


4662 


(4662 Plotter) . Assigns a communications 
protocol which assumes that the device at 
this port is a TEKTRONIX 4662 Interactive 
Digital Plotter . The plotter ' s block mode 
communications protocol is used . When 
4 1 1 0-ser ies esc ape- sequence commands are 
sent to this port , the terminal translates 
those commands into plotter commands . 
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Table 4-13 (cont) 
PERIPHERAL PORT PROTOCOL IDENTIFIERS 



r r O vOOO 1 


Identifier 
nean ing 


4662/MP 


(4662 f Multiple Pens). Similar to the 
"4662" protocol , except that the 4662 
plotter is assumed to be equipped with 
MULTIPLE PENS (Option 3D . When 41 10-ser- 
ies "escape-sequence 11 commands are trans- 

1 af pH i nf a nl of f "1 a r» o* i ? cr pommanH ci 
id Ucu in uU piu U l/Ci _L dllglldgc u uiiiJi ca u u D | 

lines (or text) drawn with different co- 
lor-indices are drawn on the plotter using 
different pens, (See the description of 
the map-index-to-pen> command for de- 
tails.) 


4662/NT 


(4662, No Translation) . Similar to "4662" 

protocol; the device at this peripheral 
port is assumed to be a 4662 plotter , and 
the plotter's block mode protocol is used . 
However , there is no translation from 
4 1 1 0-ser ies escape-sequence commands to 
plotter commands. 


4663 


(4663 Plotter) « Assigns a communications 
protocol which assumes that the device at 
this port is a TEKTRONIX 4663 Interactive 
Digital Plotter. The plotter ' s block mode 
communications protocol is used . When 
4110-series escape-sequence commands are 
sent to this port , the terminal translates 
these commands into plotter commands . 
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Table 4-13 (cont) 
PERIPHERAL PORT PROTOCOL IDENTIFIERS 



Protocol 



Identifier 

Meaning 



4663/NB 



(4663, No Blockmode). Similar to "4663" 
protocol ; the device at this port is as- 
sumed to be a 4663 , plotter , and 4110- 
ser ies esc ape- sequence commands are trans- 
lated into plotter commands . However , the 
plotter f s block mode is not used . 



4663/NT 



(4663, No Translation) . Similar to "4663" 
protocol ; the device at this port is as- 
sumed to be a 4663 plotter, and the 
plotter's block mode is used . However , 
there is no translation from 4 1 1 0-ser ies 
esc ape- sequence commands to plotter com- 
mands . 



NOTE 

If a peripheral port is to be the 
"source" in a <copy> or <spool> command , 
or if it is to be either the "source" or 
the "destination" in a <port-copy> com- 
mand y then it is necessary that the port 
have been assigned the "PPORT" protocol 
identifier. 



Defaults 



Parameter 
Number 

1 

2 



As Shipped 
From Factory 

None 
None 



On Power-Up 



Remembered 
Remembered 



If the Parameter 
is Omitted 

Error PA1 1 
Error PA21 
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Error s 



Unrecognized command . (Option 10 is not 
installed . ) 

Invalid port identifier. (Must be " P : " , 
"P1 :" ,. or "P2:" . ) 

Parameter 1 memory error . (Out of memory 
while parsing the port name <string>.) 

Port is in use. 

Invalid protocol identifier. (Must be 
"PPORT" , "4643" , "4662" , "4662/MP", 
"4662/NT" , "4663", "4663/NB" , or "4663/NT") . 

Parameter 2 memory error. (Out of memory 
while parsing the <string>.) 



References 

Seven additional commands are used to set peripheral port 
characteristics and handle their data flow; see also the 
following commands : 

<Set-port-baud-rate> command . 
<Set-port-EOF-str ing> command . 
<Set-port-f lagging-mode> command . 
< Set- port-par it y> command . 

<Set-port-stop-bits> command . 
<Port-copy> command . 
<Report-port-status> command . 



PA00 (Level 0) : 
PA 1 1 (Level 2) : 

PA12 (Level 3) : 

PA13 (Level 3) : 
PA21 (Level 2) : 

PA22 (Level 3): 
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<Fort-Copy> Command 



(Option 10) 



SETUP Mode Name: PCOPY 



SYNTAX 



<port-copy> 



(ESC)(P)(C) 

<str ing : source- specif ier> 
<string: s e p aval or-st rTng > 
<str ing : "g^sTIriation-specif ier> 



PARAMETERS 

Sourct-Speoifier ( M H0s f % W P0:" ? "P1:" f or "P2:"). 

Specifies the first of two devices between which data 
flows . 

Separator-String (Empty String or "TO") . Separates the 
source and destination specifiers . 

Destination-Specifier ("HO:", "P0:", "P1:", or "P2:") . 

Specifies the second device for the data transfer . 



Description 

Like the <copy> command , the <port-copy> command establishes 
a data path between two devices , so that a data transf er can 
take place . Unlike the <copy> command , though , the data path 
is bidirectional : the "destination" device can "talk back" 
to the " source" device during the data transfer . This 
permits the following : 

t The two devices can use a device-dependent "handshak- 
ing" protocol . 

• The source device ( typically the host computer) can 
directly query the destination device , and parse the 
destination device' s responses • 
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The data connection is established by the <port-copy> com- 
mand; the connection is broken when either device sends an 
end-of-f ile string ( or , in block mode, when the host sends a 
block with the EOF bit set). 



NOTE 

If the terminal is armed for block mode , 
then it cannot detect <E0F-str ing>s com- 
ing from the host computer. Thus, if the 
terminal is armed for block mode , but 
has not yet entered block mode, the only 
way to • terminate a <port-copy> operation 
is with the CANCEL key. If you will not 
be using the block mode feature, you 
should not arm the terminal for block 
mode • 

Valid port specifiers are: "HO:", "PO:" , "P1 :" , and "P2:" . 
" HO : Tf means the host computer. "P0: M , "P1 :" , and "P2:" 
specify RS-232 peripheral ports. 

The data communications protocols in use by the ports at the 
time of the <port-copy> command will be in effect throughout 
the data transfer. For peripheral ports ("PO:" , " P 1 : " , ff P2: 
" ) this must be the "PPORT" protocol . ( See the description 
of the <port"-assign> command for details . ) 

As with the <copy> command, all other terminal activity is 
suspended until the end-of-f ile is detected . This command 
can be prematurely terminated by pressing the CANCEL key on 
the keyboard . 



Defaults 



Parameter 
Number 



As Shipped 
From Factory 



On Power-Up 



If the Parameter 

is Omitted 



1 



None 



None 



Error PC11 



2 None None Error PC21 

3 None None Error PC31 
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Errors 



PC'OO (Level 0): Unrecognized command. (Option 10 is not 

installed) . 

PC02 (Level 2): Memory overflow caused by (ESC)(P)(C) 

command. 

PC11 (Level 2): Invalid "source" port (must be "HO:", "P0:" , 

"P1 :» , or "P2:") . 

PC12 (Level 3): Parameter 1 memory error, (Out of memory 

while parsing the source specifier string,) 

PC 1 3 (Level 3 ) : Source is busy . 

PC21 (Level 2): Invalid separator string . ( Must be the empty 

string or "TO" . ) 

PC22 (Level 3 ) : Parameter 2 memory error . (Out of memory 

while parsing the separator string . ) 

PC23 (Level 3 ) : Destination is busy . 

PC31 (Level 2): Invalid "destination" port (must be "HO:", 

"P0: " , " P 1 : " or "P2: " , and must be different 
from the " source" port) . 

PC32 (Level 3)- Parameter 3 memory error . ( Out of memory 

while parsing the destination specifier . ) 

PC33 (Level 3): Destination device is busy . 

Ref er ences 

<Copy> command . 
CANCEL key. 
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<Fort-Status-Report> Message Type 



(Option 10) 



SYNTAX 

<port- status- report> = 



[ < EDM- indie at or > ] 

[ <s.ig-char> ] 

<port-ID-code> 

[ <p6rt-inf ormation> ] 

<EOM- indicator > . 



<port-ID-code> = <char-report><char-report> 



(See Note 1 . ) 

(See Note 2.) 

(See Note 3. ) 

(See Note 4. ) 



< port- in format ion> 

= <int-report 
. <int-repor t 
<int-report 
<int-report 
<int-report 
<int-report 
'■<int-report 
<str ing-report 



baud-rate> 
par ity> 



stop-bits> 

Tata^¥Tts> 
TTa^gIn^mode > 
"TTag gTn^^go 7r - c h a r a c t e r > 
f lagging- 11 sto p ff - char act er > 

Note 5 .) 

<int- array-report 
< in t- array-report 



EOF-string> 



Note 1 • An < EOM- indicator > is included at the begin- 
ning of a <port-status> report only if both the 
following conditions are met : ( a) At least one charac- 
ter has already been sent on the current line ( that 
is , since the last <EOM-indicator> ) . (b) If the line 
were not terminated ( with this <EOM-indicator> ) then 
the remainder of the <port-status-report> could cause 
the current maximum line length to be exceeded . 

Note 2* The signature- character ( <sig-char> ) is only 
sent if it is not (NUL) . 

Note 3 • The <port-ID-code> consists of two <char- 
report>s which identify the peripheral port: (P) (0) , 
(P)(1 ) , (P) (2) , or (SP)(SP) . The last code, (SP)(SP) , 
is used only if the < report- port- st a tus> command in- 
cluded an invalid port-specifier <string> . 
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Note 4. The < port- in format ion> is sent only if the 
<report-port-status> command had a valid port- 
specifier <string>. In other words, if the <port-ID- 
code> is ( SP) ( SP) , then the < port- in format ion> is 
omitted • 

Neti 5V This <str ing-report> always has ten <char- 
report>s . That is, the length of the device-driver- 
name string is always ten characters . 



Description 

If the terminal is equipped with Option 10, then it sends a 
<port-status-report> to the host computer when commanded to 
do so by a <report-port-status> command. (The <report-port- 
status> command is described elsewhere in this section.) 

<E0M-Indioator> • An <EOM-indicator> may be sent at the start 
of the <port-status-report> . This optional <EOM-indicator> 
is provided because of the terminal ' s "maximum report line 
length" feature. This <EOM-indicator> is included in the 
<port-status-report> only if it is needed to prevent the 
current maximum line length from being exceeded . ( See the 
description of the <set-report-max-line-length> command for 
details . ) 

If the terminal is not in block mode , the <EOM-indicator> is 
the current <E0L-str ing> - typically , just the (CR) charac- 
ter . In block mode , the <EOM-indicator> is sent by terminat- 
ing the block and setting the " end- of-mes sage" bit in the 
<block-control-bytes> . For details , see the description of 
the <EOM-indicator> syntactic construct . 

When the terminal sends a report to the host , bypass mode is 
entered . ( See <enter-bypass-mode> . ) 
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<Slg"Chlf> 9 The <sig-char> (signature character) is provided 
for easier parsing of the report by the host computer. (If 
graphic input is active , the signature character allows the 
host to distinguish this report from GIN reports which are 
part of a <GlN-report-»sequence> » ) The signature character in 
the <port-status-report> is the current <sig-char> for non- 
GIN reports, as set by the most recent <set-»report>»sig-» 
chars> command. If this current <sig-char> is (NUL) , then it 
is omitted from the <port-status-rep..ort> . 

(For more information on signature characters, see the 
description of the <set-report-sig-chars> command.) 

<Port-ID-Code> . Next comes a two-letter code: ( P ) (0 ) , 

(P)(1), (P)(2), or (SP)(SP). This names the RS-232 peripher- 
al port to which the . <port-sfeatus-report> pertains. To avoid 
any possibility of exceeding the current maximum line 
length, these two characters are sent to the host as <char- 
report> s . (For more information on this, see the descrip- 
tions of the -. <set-max-line-length> command and the <char- 
report> syntactic construct . ) 

A <port-ID«-code> of (SP)(SP) indicates that the <report- 
port-status> command had an invalid port-specif ier; <string> . 
If that is the case, then then the following <port-informa- 
tion> is omitted . 

<POf t»Information> . The <port-informa.tion> consists of a 
series of <int-report>s , <strin-g-report>s , and <int-array- 
report>s. These contain the current values of the peripheral 
port's parameters • baud rate, parity, number of stop bits , 
etc . 
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Flnil <EOM-Indicator> . The < port- status- report> ends with an 
<EOM-indicator> . This final <eom-indicator> is always sent; 
it helps ensure that the host applications program actually 
receives the < port- statu s-report> in a timely manner . ( In 
some host operating systems , the user application program 
does not receive a message from the terminal until the 
terminal sends a (CR) or other end-of-message indicator • ) 

If the terminal is not in block mode , the <EOM-indicator> is 
the current <EOL-string> ; typically , this is just the (CR) 
character . In block mode, the <EOM-indicator> is sent by 
terminating the block and setting the "end-of-message" bit 
in the <block-control-bytes> • 



References 

<EOM-indicator> 
<Report-port-status> 
<Set-port-baud-rate> 
<Set-port-EOF-string> 
<Set-port-f lagging-mode> 
< Set- port- par it y> 
<Set-port-stop-bits> 
<Set-report-sig-char s> 
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<Prompt-Mode> Command 



SETUP Mode Name : PROMPTMODE 



SYNTAX 

<prompt-mode> = (ESC) (N) (M) 

<int: prompt-mode> , 

PARAMETERS 

Prompt-Mode (0 to 2). = NO; turn prompt mode off. 1 
= YES ; turn prompt mode on after the next <EOM-char> 
or <EOL-str ing> . 2 = turn prompt mode on immediately . 



De scription 

If the <int> parameter is zero , prompt mode is turned off 
and any characters in the terminal 1 s output queue are 

transmitted* 

If the parameter is one , the terminal waits until it has 
encountered an <E0M-char> or in the data it sends to the 
host . After sending the <E0M-char> or , the terminal enters 
prompt mode . 

If the parameter is two , the terminal enters prompt mode 

immediately* 

When the terminal is in prompt mode , the terminal ' s output 
queue can be filled while waiting for a prompt from the host 
computer , When the output queue is full , the keyboard is 
temporarily locked and pressing a key simply rings the bell . 
The keyboard unlocks when the terminal receives a prompt to 
empty its output queue , when the host computer sends a 
command to exit prompt mode , or when the terminal is reset . 
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Defaults 



Parameter 
Number 



k& Shipped 
From Factory 



On Power-Up 



If the Parameter 
is Omitted 















Errors 



NM11 (Level 2): Invalid prompt mode parameter (must be , 

1 ,or 2) . 

Ref erences 

<Set-EOM-chars> command . 
<Set-prompt-str ing> command . 
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<Prottot-File> Command (Options 42 and 43) 



SETUP Mode Name: PROTECT 



SYNTAX 




<protect-f ile> = 


(ESCMJMP) 

<str ing : file-specif ier> 
<int : write-pr6£ect-mode> .■ 


PARAMETERS 




File-Specifier* 

tection is being 


Names the disk file whose write-pro- 
specified . 


Write-Protect-Mode (0 or 1 ) . = NO; the file is not 
wr ite-protected . 1 = YES ; the file is wr ite-protected . 



Description 

This command sets or clears the wr ite-protect flag on the 

specified file or disk volume . Note that thi s operation is 

distinct from the hardware wr ite-protect that is controlled 

by a notch in the disk and/or a front panel switch . 

To protect or unprotect a specific disk file , include both 
the disk drive number and the filename in the <str ing> 
parameter . For example , <string : ?f F0 : MYFILE" > specifies the 
file named MYFILE on disk drive zero . 

To protect or unprotect an entire disk volume , specify only 
the disk drive number in the <str ing> parameter . For 
example , <str ing : " F0 : "> specifies the entire disk volume 
installed in disk drive zero . If an entire volume is 
protected , none of the files in that volume can be written 
over , regardless of the individual wr ite-protect flags for 
those files . 
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Protected files or volumes may not be deleted by the 
<delete-f ile> command. A <format> command , however , can 
overwrite individual protected files . 



Defaults 

Parameter 
Number 

1 

2 

Errors 



As Shipped 
From Factory 

None 

1 



On Power-Up 

None 
1 



If the Parameter 
is Omitted 

Error JP11 

1 



JPOO (Level 2): 

JP10 (Level 2): 

JP11 (Level 2): 

JP12 (Level 3) : 

JP13 (Level 2): 

JP19 (Level 2): 

JP21 (Level 2): 
References 



Unrecognized command . ( Disk drive option is 
not installed . ) 

The specified file or disk drive does not 
exist . 

Invalid file specifier . 

Parameter 1 memory error . ( Out of memory 
while parsing parameter 1 . ) 

Either the specified device is not a disk 
drive , or the file ( or entire diskette vol- 
ume) has been wr i te-protected . 

Disk hardware error . ( I/O error , drive not 
ready , or hardware wr ite-protect error . ) 

Invalid protection mode (must be or 1 ) . 



< Forma t-volume> command 
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<Raster-Wrlte> Command 4112, 4113 



SYNTAX 

<raster-write> = (ESC) (R) (P) 

<i- n t+* n ^ m be r-of-pixels> 
<char-array :"^coTor^Tn^ . 

<char-array: color-index-codes > = <int+ : count> 

[ <code> ... J . 

<code> = an ASCII character in the range from ( SP) to 
(*); that is , a character whose decimal 
equivalent is in the range from 32 to 96 . 

PARAMETERS 

Number-Of-Pixels (0 to 65535) . Specifies the number of 
pixels represented -in the following <char-array> . 

color- index- Codes . A <char-array> whose individual 
characters hold color-indices in a packed format. 

L____- 



Description 

The <raster-wr ite> command is one of two commands for 
specifying the color-indices of individual pixels . ( The 
other such command is <runlength-wri.te> . ) If the <raster- 
write> command occurs between a <begin-f ill-pattern> command 
and an <end-f ill-pa'ttern> command/ then it specifies the 
color-indices of pixels within a fill pattern ; otherwise, it 
specifies the color-indices of pixels in the current pixel 
viewport . 
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The data bits embedded within the <code> characters in the 
<char-array> are regarded as a continuous string of bits, 
and are grouped to form color-indices for individual pixels, 
(The bits are grouped to form color-indices according to the 
!! bits-per-pixel l! parameter in the most recent <begin-fill- 
pattern> or <begin-pixel-oper ations> command. Which of these 
two commands is used depends on whether the <raster-wr ite> 
command is specifying bits for a fill pattern or for the 
pixel viewport.) 

Starting at the current "pixel beam position , " the pixel 
viewport is filled (with color-indices) from left to right 
across a single row of pixels. As each color-index is loaded 
into the fill pattern or pixel viewport, the pixel beam 
position moves to the following pixel on that row. On 
encountering the right edge of the fill pattern or pixel 
viewport, the beam position moves to the leftmost pixel in 
the row below. 



<Int> and <Code-Array> Parameters 

Figure 4-9 shows how to pack color-indices into the <raster- 
write> command's <char-arr ay> parameter. 



Special Cases 

Thi C ) Character. The special <code> character D, ASCII 
decimal equivalent 96, serves like a ( CR) (LF) sequence in 
alphatext: it moves the pixel beam position to the start of 
the following row of pixels. If the <r aster-wr ite> command 
is defining a fill pattern, then a ( x ) code sets the 
remaining pixels on that row of the fill pattern to color- 
index zero . If , on the other hand , the <raster-wr ite> 
command is sending color-indices to the pixel viewport , then 
a ( % ) code leaves unchanged the following pixels on that row 
of the pixel viewport . 

The ( N ) code is not included in the pixel count . 
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If lf bits-per-pixel" is 3 , then the color- ind ices , 0, 2, 3 , 
2, 7 are packed into a <raster-write> command as follows: 

1. Express the color- ind ices as 3-bit binary numerals: 

2 3 2 7 

\ \ \ \ i \ 

000 000 010 011 010 111 

2. Group the binary bits into 6-bit groups: 

,000 000, ,010 011, ,010 111, 

I t t 

000000 010011 010111 

3. Add 32 (binary 100000) to these 6-bit binary numerals 
to form 7-bit ASCII characters: 

0100000 0110011 0110111 

\ \ \ 

(SP) (3) (7) 

4. Issue the < raster-wr ite> command. The command's first 
parameter is < int : 6>, because the command holds 6 
color- ind ices . The second parameter is a < char- ar r ay> 
holding the characters (SP), (3), and (7). 

<raster-write> = (ESC)(R)(P) 

<int: 6><char-array : ( S P ) , ( 3 ) , ( 7 ) > 

= (ESO(RKP) (6) (3)(SP)(3)(7) . 



Figure 4-9. Packing Color-Indices into the <Raster-Write> 

Command . 
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To© Many Color-Indices. If too many color-indices are sent 
in the <code-arr ay> , so that the pixel beam position would 
move below the bottom line of the fill pattern rectangle, 
then one of two things can happen: 

. If the <raster-wr ite> command is part of a <f ill- 
pattern-def init ion> , that < fill-pat tern-definition> 
ends when all the color-indices for the fill pattern 
have been specified . There is no need , in this case , 
for an < end-fill-patter n> command . ( Such a command , if 
received , will be ignored . ) Excess color-indices with- 
in the same <r aster-wr ite> command are ignored . 

( Since the < f ill-pattern-def init ion> has been termi- 
nated , subsequent <raster-wr ite> and <runlength-wr ite> 
commands will send their color-indices to the pixel 
viewport rather than the fill pattern rectangle . ) 

, If the <raster-wr ite> command is not part of a <f ill- 
pattern-def init ion> , then it is sending color-indices 
to the current pixel viewport . In that case , the pixel 
beam position "wraps around" from the last pixel in 
the bottom row of the pixel viewport to the first 
pixel in the top row of that viewport . 

On®, Two , or Three Bits Per Pixel . If the bits-per-pixel 
parameter in the <begin-pixel-operations> or <begin-f ill- 
pattern> is one , then six color-indices ( each consisting of 
a single bit) will fit into each <code> character . If bits- 
per-pixel is two , then three color-indices fit into each 
<code> character . If bits-per-pixel is three , then two 
color-indices fit into each <code> character , as shown in 
Figure 4-9 . 
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Four Bits Per Pixel* In the 4113? the bits-per-pixel parame- 
ter may be set to four . In that case, one and a half color 
indices fit into each <code> character. That is, every pair 
of <code> s holds three color-indices . Figure 4-10 shows the 
packing scheme. 
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If 


the "bits-per-pixel" is 4, then the color- indices 


o, 


, 2, 3 > 12, 15 are packed into a <raster-wr ite> 


command as follows : 


1 . 


Express the color- ind ices as 4-bit binary numer- 




als: 




2 3 12 15 

\ \ \ \ \ \ 




r\r\f\rs r\nr\c\ nm n nnii 1 1 nn 1111 

UUUU U UUU UU I U UU I I I I UU MM 


2. 


Group the binary bits into 6-bit groups: 




nnnn nnnn nni n n n 1 1 iinn 1111 

UUUU UUUU UU I U UU I I I I UU MM 

v—^-y. * ^— — — „y \ wamam ^^»^^ / 




1111 

* T Y * 

onnnnn nnnn 1 n nn 1111 nni 1 1 1 

UUUUUU UUUU I U UU MM UU MIS 


3. 


Add 32 (binary 100000) to these 6-bit binary 




n 1 1m oval <3 1" f\ -pn vro 7 «* H i AQf T T phavap for c • 




0100000 0100010 0101111 0101111 

\ \ \ \ 




(SP) (") (/) (/) 


4. 


Issue the <raster-wr ite> command. The command's 




first parameter is < int : 6>, because the command 




holds 6 color- ind ices . The second parameter is a 




<char- arr ay> holding the characters (SP), ("), 




(/) , and (/) . 




<raster-wr ite> = (ESC) (R) (P ) 




<int: 6> 




<char-array: (SP) ,( ") ,(/) ,(/)> 




= (ESC)(R)(P)(6)(4)(SP)(»)(/)(/) . 



Figure 4-10. A <Raater-Write> Command With Four Bits Per Pixel. 
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Six Bits Per Pixel . If the bits-per-pixel parameter in the 
<begin-pixel-operations> or <begin-fill-pattern> command is 
six, then the terminal interprets each <code> character as 
containing only one color-index . In the 4112, the least- 
significant three bits of the <code> character determine a 
color-index in the range from to 7 . In the 4113, the 
least- significant four bits are used , permitting color- 
indices in the range from to 15. 

Thus , if bits-per-pixel = 6 , you can represent each color- 
index in the range from to 7 with a single ASCII character 
in the range from (0) to (7). For the 4113, color-indices in 
the range from to 15 can be represented as ASCII charac- 
ters in the range from (0) to ( ?) . ( Coincidentally , these 
are the same as the <int> parameters for numbers in the 
range from to 15.) 



Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 None None Error RP1 1 

2 None None Error RP21 



Errors 



RP00 (Level ) : Unrecognized command . ( The terminal is not a 

4112 or 4113.) 

RP11 (Level 2) : Invalid number of pixels . (Must be in the 

range from to 65535.) 

RP21 (Level 2 ) : There are too many or too few pixels in the 

<code-arr ay> . 

RP22 (Level 3 ) : Parameter 2 memory error . ( Out of memory 

while parsing the <char-arr ay> parameter . ) 
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Ref erences 



< Begin-fill-patter n> command . 
<Begin-pixel-operations> command • 
< Run length- writ e> command . 
<Set-pixel-viewport> command . 
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<Real> Parameter Type 



SYNTAX 

<real> = <int : mant i ssa > 

< int : power-of-'two > . 

COMPONENTS 

Mantissa . An integer , represented as an <int> parame- 
ter . 

Power»of«Two. An <int> telling the power of two by 
which the mantissa is multiplied. 



Description 

To send a real number to the terminal (as a parameter for 
one of its commands) , you represent it in the form "A times 
the Bth power of two/ 1 where A and B are integers . Send A 
first , and then B , packed in the <int> parameter format, 

Examples « The number 1.5 may be expressed as 3 times 1 /2 or 
3 times 2 to the power -1. Here , A = 3 and B = -1 ; hence 

<real : 1 .5> = <int : 3><int : -1> = (3) ( ! ) . 

The number pi may be approximated as 25736/8 1 92 , or 25736 
times 2 to the power -13. Here A = 25736 and B = -13; hence 

<real : pi> .= <int : 25736><int : -13> 
= (Y)(H)(8) (-) . 



A Sample Routine. Figure 4-1 1 shows a PASCAL procedure to 
issue <real> parameters to the terminal . 



Ref erences 

<Int> parameter type . 
<Real-report> parameter type* 
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PROCEDURE SendReaKReal Number : REAL) ;{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{ } 

{} CONST {} 

{} Epsilon = 0.00006104; {** 2 to the power -16 **} {} 

{ } VAR {} 

{} Mantissa, Exponent : IntType ; { } 

{} Negative : BOOLEAN; {} 

{ } BEGIN , {} 

{} { ** We'll work on positive numbers ...**} {} 

{} Negative : = (RealNumber < 0.0); {} 

{ } IF Negative { } 

{} THEN RealNumber : = -RealNumber; {} 

{} { ** Initialize Exponent. ** } { } 

{ } Exponent : = ; { } 

{} { ** If there's a fractional part, we need more precision.. ** } { } 

{} WHILE (RealNumber > (Trunc( RealNumber ) + Epsilon)) {} 

{} AND (Trunc(RealNumber) < 16383 ) DO {} 

{} BEGIN {} 

{} RealNumber : = RealNumber * 2.0; { } 

{ } Exponent : = Exponent - 1 ; { } 

{} END; {} 

{ } { ** If the number's a 1 arge integer , we need a pos . exponent ** } { } 

{} WHILE (RealNumber > 32767. 0) DO " { } 

{ } BEGIN {} 

{ } Real Number : = Real Number / 2.0; { } 

{ } Exponent : = Exponent +1; { } 

{} END; . {} 

{ } { ** Okay , now ship off the Mantissa and Exponent . ** } { } 

{ } Mantissa : = Trunc ( Real Number + 0.5); { } 

{ } IF Negative { } 

{ } THEN Mantissa := -Mantissa ; { } 

{ } { ** Ship off the Mantissa and Exponent . ** } { } 

{ } Send Int( Mantissa) ; { } 

{ } Sendlnt(Exponent) ; { } 

{} END; {} 
{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}{} 



3892-10 

Figurt 4-1 1 . Sending a <Real> Parameter in PASCAL. 
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<Real-Report> Parameter Type 



SYNTAX 

<real-report> = <int-report : mant issa> 

<int-report : power-of-two> 



Description 

The <real-report> parameter type resembles the <real> param- 
eter type , but with these differences: 

, <Real-report>s are used by the terminal to send real 
numbers to the host computer , whereas <real> 
parameters are used by the host computer, to send real 
numbers to the terminal. 

The terminal sends <real-report> s as pairs of <int- 
report>s , whereas the host computer sends <real>s as 
pairs of <int>s . 



References 

<Real> parameter type . 
<Int-report> parameter type . 
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<Rectangle-Fill> Command 4112,4113 



SYNTAX 

<rectangle-fill> = (ESC) (R) (R) 

<xy : lower- left- corner > 
<xy : u p p e r - r i g h t - c oFne r > 
<int+ : f ill-index> . 

PARAMETERS 

Lower-Left-Corner (It : to 639, Y = to 479). 

Specifies one corner of a rectangle in raster memory 
space . 

Upper-Right-Corner (X = to 639, Y = to 479). 

Specifies the opposite corner of that rectangle . 

Fill-Index (0 to 65535) . The color-index with which 
the rectangle is to be filled . 



Description 

The specified rectangle, on the current surface in 640 by 
480 raster memory space , has all its pixels set to the 
color-index specified in the <int> parameter . Here , "current 
surface" means the surface specified in the most recent 
<begin-pixel-operations> command . The color-indices are 
written into the raster memory using the ALU mode specified 
in that same <begin- pixel-ope ration s> command . 

Two opposite corners of the rectangle are specified by the 
two <xy> parameters . It is expected that the lower left 
corner will be specified first , followed by the upper right 
corner . ( However , any pair of opposite corners will do , with 
their xy-coordinates specified in any order . ) The x-coordi- 
nates must be in the range from to 639 , and y-coord inates 
in the range from to 479 • 
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If the left and right edges of the rectangle have the same 
x-value , then the rectangle filled will be one pixel wide . 
Likewise , if the upper and lower y-values are the same, then 
the rectangle filled will be one pixel high. 



Defaults 

Parameter 
Number 

1 

2 
3 

Errors 



As Shipped 
From Factory 

None 

None 
None 



On Power-Up 

None 
None 
None 



If the Parameter 
is Omitted 

to, a) 

(0,0) 

o 



RR00 (Level 0) 

RR11 (Level 2) 

RR21 (Level 2) 

RR31 (Level 2) 
References 



Unrecognized command'. - ( The terminal is not a 
4112 or a 4113. ) 

Invalid "lower left" coordinates . (X must be 
in the range from to 639 , and Y in the 
range from to 479 . ) 

Invalid "upper right" coordinates. ( X must 
be in the range from to 639 , and Y in the 
range from to 479 . ) 

Inval id fill-index ( must be in the range 

from to 65535-. ) 



<Begin-pixel-operations> command 
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<Rename-File> Command (Options 42 and 43) 



SETUP Mode Name: RENAME 


SYNTAX 




<rename-file> = (ESC) (J)(R) 

<string : old~f ile-.name> 
<str ing : separ ator-str ing> 
<string: new-f ile-name> • 




PARAMFTFRS 




Old-File-Name. A <string> of the form "filename" 
"Fn : filename , " where Fn specifies the disk drive 
sume FO if omitted). 


or 

( as- 


Separator-String. The empty string or "TO" . 




New-File-Name. A <str ing> specifying the file 1 s 

name. 


new 


separator string 

( empty string or "TO" ) 




new file specifier 
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( 



Description 

The file specified by the "old file specifier" string is 
renamed to the name specified by the "new file specifier" 
string . 

Flit •peetfifff/ The file specifiers take the form "FO : 
filename" or "F1 : filename" , where "filename" is a sequence 
of up to nine alphabetic or numeric characters . 

The two file specifiers must agree in their "FO:" or "FT:" 
fields. (If this field is omitted , it is assumed to be "FO: 
ff .) 

The command fails. if the file is wr ite-protected , if the 
file "old file name" does not exist, if a file already 
exists with the "new file name," or if the disk unit is not 
present-.. 



Defaults 



Parameter 

Number 



Aa Shipped 
From Factory 



On Power-Up 




Is Omitted 



None 



None 



Error JR1 1 



2 



None 



None 



Error JR21 



None 



None 



Error JR31 
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Errors 



JROO (Level 2): Unrecognized command . (Disk drive option is 

not installed . ) 



JR10 (Level 2) 

JR11 (Level 2) 

JR12 (Level 3) 

JR 13 (Level 2) 

JR19 (Level 2) 

JR21 (Level 2) 

JR22 (Level 3) 

JR30 (Level 2) 

JR31 (Level 2) 

JR32 (Level 3) 

Ref erences 



: The specified device or file does not exist , 

: Invalid "old" file specifier . 

: Parameter 1 memory error . ( Out of memory 
while parsing parameter 1.) 

: Either the device specified in parameter 1 
is not a disk drive , or the file ( or entire 
diskette) has been wr it e- protected . 

: Disk hardware error . ( I/O error , drive not 
ready , or hardware wr ite-protect error . ) 

: Invalid separator string ( must be empty 
string or "TO") . 

: Parameter 2 memory error • ( Out of memory 
while parsing parameter 2 . ) 

: Either the device specified in parameter 3 
does not exist , or the "new" filename al- 
ready is in use . 

: Invalid device specifier in parameter 3 • 

: Parameter 3 memory error . ( Out of memory 
while parsing parameter 3 . ) 



<Copy> command , 
<Protect-file> 



command 
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<Renaae-Segaent> Command 



SYNTAX 




<rename-segment> ' = 


(ESC)(S)(R) 


<int! o ld-segmen u-numoer > 




<int : new-segment-number> * 


PARAMETERS 




Old-Segmerat-Number 


(1 to 32767) • Number of the segment - 


being renamed. 




New-Segment-Number 


( 1 to 32767). New name for the 


segment. 





De scr iption 

This command renames (renumbers) an ex isting segment • The 
segment number is changed to the new-segment-number , shown 
above as the second <int> parameter . If a segment with the 
new-segment-number already exists , an error occurs and the 

segment is not renamed* 

Valid segment numbers are in the range from 1 to 32767. 
Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 None None Error SR1 1 

2 None None Error SR21 
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Errors 



SR02 (Level 3): Out of memory while renaming a segment (4114 

only) . 

SR03 (Level 2): Command is invalid at this time. (The speci- 
fied segment is currently being defined.) 

SR10 (Level 2) : Segment does not exist. 

SR11 (Level 2): Invalid segment number (must be in the range 

from 1 to 32767) . 

SR20 (Level 2): A segment with that segment number already 

exists* 

SR21 (Level 2): Invalid segment number (must be in the range 

from 1 to 32767) . 

References 

<Begin-new-segment> command . 
<Begin-segment> command . 
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<Renew-View> Command 




QfTTIip MoHp Momp' RFMPW 
kJL 1 Uf i 1 vj U t? Vi d 111 <c • n Ei 1M Ej w 




SYNTAX 




<renew-view> = (ESC) (K) (N) 

<int : view-number> . 




PARAMETERS 




View-Number (-1 to 64). In the 4114, 

has no effect. In the 4112 and 4113, 
view to be renewed. Zero means "the 
Minus one means " all views . M 


this parameter 
it specifies the 
current view . " 



Description 

On a 4114, the <renew-view> command erases the screen and 
redraws all visible segments. On a 4112 or 4113, the <renew- 
view> command erases the current view and redraws all 
segments visible in that view, plus the border and the 
framing box , if applicable . On both terminals , the dialog 
area is made visible again after the segments are redrawn 
(if it was visible before). 

4114 View Number . The "view number" is an <int> in the range 
from -1 to 64 . This parameter has no effect ; it is only 
included for compatibility with other TEKTRONIX terminals. 
C Probably the simplest thing is to set this parameter always 
to 1 ; that way , the <renew-view> command always consists of 
the characters ( ESC) (K) ( N) ( 1 ) . ) 

4112 and 4113 View Number. In the 4112 and 4113, if the view 
number is in the range from 1 to 64 , then that view ( if it 
exists) is "renewed . " That is , the viewport for that view is 
erased , and all the view' s visible segments are redrawn . If 
the specified view does not exist , then a type KN10 error 
occurs . 
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In the 4112 and 4113, specifying view number zero causes the 
current view to be renewed. Specifying view number - 1 causes 
the terminal to erase the screen and then renew all views in 
sequence , ending with the current view. 

4113 View Display Clusters* In the 4113 it is possible to 
group several views together in a "view display cluster . " If 
this is done , then whenever a <renew-view> command is issued 
for any view in the cluster , all views in the cluster are 
renewed . For details , see the description of the <set-view- 
display-cluster> command . 



Defaults 



Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 None None 



Errors 



KN02 (Level 3 ) : Out of memory while attempting to renew a 

view . ( This error can also occur as a result 
of pressing the PAGE key . ) 

KN10 (Level 2): The view specified does not exist . 

KN11 (Level 2 ) : Parameter out of range (must be in the range 

from -32768 to +32767) . This parameter 
should be in the range from -1 to 64; 
however , the terminal will substitute -1 in 
place of a value which is less than - 1 , and 
+64 in place of a value which is greater 
than +64 . 



References 



<Select-view> command . 
<Set-segment-visibility> command . 
command . 
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( 



( 
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<Report-Colorhardeopy-Status> Coamand 4113 

Option 9 



SYNTAX 

<report-colorhardcopy-status> s(ESC) (Q) (Q) 



Description 

The <report~colorhardcopy-status> command causes the termi- 
nal to send a <colorhardcopy-status-report> to the host 

computer. 



Errors 

QQOO (Level 0) : Unrecognized command (Option 9 not in- 
stalled) • 

References 

<Colorhardcopy-status-report> message type . 
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<Report*Devlce-Status>. Command 



SYNTAX 

<report-device-status> = (ESC) ( J ) (Q) 

<string : device- spec if ier > . 

PARAMETERS 

Deviee«Specif ier • Specifies the device whose status is 
to be reported to the host* Valid <string>s are 11 H0: ,f 
(for the host communication port), "FO: 11 and 11 F 1 : 11 
(for disk drives) , "P0: f1 , " P 1 : " , and f, P2: ,f (for RS-232 
peripheral ports) , and " HC :" ( for the color hardcopy 
interface) . 



Description 

This command causes the terminal to send a <dev ice-status- 
report> for the specified device to the host computer • The 
device may be the host communication port ("HO:"), a flexi- 
ble disk drive ( "FO:" or " F 1 : " ) , an RS-232 peripheral port 
("PO:" , " P 1 : » , or "P2:") , or, if Option 9 is installed, the 
color hardcopy interface ( "HC : ff ) • 

If a valid but not installed dev ice is specified as the 
<str ing> parameter, the terminal detects a JQ10 error and 
returns zero as the status integer in the <device-status- 

report> • 

If an inval id dev ice code is specified as the <str ing> 
parameter , the terminal detects a JQ1 1 error . Nevertheless , 
the terminal sends a <device-status-report> to the host 
computer with ( SP) (SP) as the returned two-character device 
mnemonic , and zero as the status integer . 
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Defaults 

Parameter 
Number 

1 

Errors 



As Shipped 
From Factory 

None 



On P©**er«Up 

None 



If the Parameter 
is Omitted 

Error JQ1 1 



JQ10 (Level 2): Device is not installed. 

JQ11 (Level 2): Invalid device specifier . 

JQ12 (Level 3) • Parameter 1 memory error* (Out of memory 

while parsing parameter 1 . ) 

References 



<Device-status-report> message type • 
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<Report-Errors> Command 



SYNTAX 




<report-error s> = 


: (ESC) (K)(Q) 



Description 

The <report-error s> command causes the terminal to send an 
<errors-report> message to the host computer. In that 
message , the terminal reports the eight most-recently de- 
tected error codes, their severity levels, and how many 
times each error was detected . See the description of the 
<error-report> for details. 

The most recent error will be returned first, and the 
"signature" characters used are those which have been speci- 
fied for reports . 

When the terminal sends a report to the host , bypass mode is 
entered . ( See <enter-bypass-mode> . ) 

This command is intended to be issued by the host computer . 
It should not be typed by the operator with the terminal in 
LOCAL mode. 



Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

None required None required None required 
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Errors 

No errors are detected for this 
References 

Appendix C , "Error Codes." 
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command , 
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<Report-GlN™Point> Command 



SYNTAX 

<report-gin-point> = (ESC) (I) (P) 

<int: dev ice- funct ion-cod e> . 

PARAMETERS 

Device-Function- Code • Valid values are -2 (reports the 

graphic beam position), and numbers of the form 8D+F , 
where D is a device code (0 , 1, or 3) and F is a 
function code ( , 1, or 2). 



Description 

The <report-GIN-point> command forces the terminal to return 
to the host a GIN report for one "GIN event , " without any 
operator interaction . This is a locator event , a pick event , 
or a stroke event , depending on the command 1 s device- 
function code parameter . 

If GIN rubberbanding or inking is enabled for that device- 
function code 9 then the terminal performs the appropriate 
rubberbanding or inking function on its display . 

The position returned is the location in terminal space of 
the graphic cursor for the specified device-function code . 
(However , for device- function code -2 , the position returned 
is the current graphic beam position . ) 

When the terminal sends a report to the host , bypass mode is 
entered . ( See <enter-bypass-mode> . ) 



Devioe-»Funotlon Code. The device^function code specifies 
which graphic input device is to be used , and which graphic 
input function ( locator , pick , or stroke) is to be used . 
This parameter is identical to the corresponding parameter 
in the <enable-GIN> command; for details , see the <enable- 
GIN> command description* 
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Specifying "-2" for the device-function code causes the 4 1 1 X 
to report the current graphic beam position . The beam 
position is reported with 12-bit accuracy for the x- and y- 
coordinates . (If only 10-bit accuracy is required , then the 
<re port- 401 0-status> command can be used instead . ) 

Tifmlnal Already Enabled for That Device and Function, if an 

<enable-GIN> command has already enabled the terminal for 
the specified device-function code , then the <report-GIN- 
point> command serves only to force a "GIN event . " The 
terminal behaves as if the operator had initiated the GIN 
event , except that the ASCII character returned as the "key- 
pressed" part of the GIN report is always the ( SP) charac- 
ter . 

Terminal Not Already Enabled for That GIN Device and 
Function. If the terminal was not already enabled f or the 
specified GIN device-function code , then the following oc- 
curs : 

1 • The terminal executes an implicit <enable-GIN> command 
f or that device- function code and a "count" parameter 
of one . 

2 . The terminal sends to the host the <GIN-report- 

sequence> for the implicit <enable-GIN> it has just 
executed . In the report , the <xy> parameter shows the 
position in terminal space for the cursor currently 
assigned to the specified device-function combination . 
In the report , the "key pressed" < ASCII-char> parame- 
ter is the ( SP) character . 

The graphic cursor "blinks" momentarily . ( The graphic cursor 
turns on as the terminal executes the implicit <enable-GIN> 
command . Then it turns off again as the <GIN-r eport-se- 
quence> is sent to the host computer . ) 
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c 



Defaults 



Parameter 

Number 



As Shipped 

From Factory 



On Power-Up 



If the Parameter 
is Omitted 



None 



None 



Error IP 11 



Errors 



1011 (Level 2 ) : Invalid device- function code, (See the 

description of the <enable-GIN> command for 
a list of valid device-function codes*) 

IE10 (Level 2): The specified GIN device is not installed in 

the terminal. 

IP 1 3 (Level 2): The device-function code names a device 

which has already been enabled for a differ- 
ent graphic input function . 

Ref erences 

<Report-401 0-status> command. 
<Enable-GIN> command . 

<GIN-report-sequence> syntactic construct. 

<GIN-locator-report> 

<GIN-pick-report> 

<G I N- stroke- report > 

<Set-GIN-rubberbanding> command. 

<Set-GIN-inking> command. 



( 
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SETUP Mode Name: PORTSTATUS 



SYNTAX 

<report-port-status> = (ESC) (P) (Q) 

<str ing : port-identif ier> . 

PARAMETERS 

Port-Idtntifitr ("P0:% "P1:% or "P2: w >. Specifies 
the peripheral port whose status is to be reported . 



Description 

When the <re port- port- statu s> is invoked by its escape 
sequence , the terminal sends a <port-status-repor t> for the 
specified RS-232 peripheral port to the host computer . When 
the command is invoked by the operator in SETUP mode , the 
terminal displays status information about the specified 
port on its screen . 

When the terminal sends a report to the host , bypass mode is 
entered . ( See <enter-bypass-mode> . ) 

Port Identifier . The <string> parameter specifies the RS-232 
peripheral port for which the report is to be generated . 
Here , " P : " means peripheral port zero , " P 1 : " means peri- 
pheral port one , and "P2 : " means peripheral port two . 

If this parameter is invalid (neither "P0: fT , "P1: T \ nor "P2: 
" ) , then the terminal detects a type PQ11 error . Neverthe- 
less , it still sends a <por t-status> report to the host 
computer . That report , however , is abbreviated ; its <port- 
ID-code> consists of two "space" characters , and the <port- 
information> is omitted . For details , see the description of 
the < port-status-re port> message type . 
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(Option 10) 
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Defaults 



Parameter 
Number 



As Shipped 
Frosi Factory 



On Power-Up 



If the Parameter 
is Omitted 



None 



None 



Error PQ11 



Errors 



PQOO (Level 0): Unrecognized command. (Option 10 is not 

installed) . 

PQ11 (Level 2): Invalid port identifier (must be "P0:" , "P1 : 

11 , or "P2: ff ) . 

PQ12 (Level 3): Parameter 1 memory error . (Out of memory 

while parsing the port specifier string,) 

References 

<Copy> command . . 

<Enter-bypass-mode> command, 

< Port- status-re port> message type . 
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<Report-Segment-Status> Command 



SYNTAX 

< report- segment- st at us> = ( ESC) ( S) (Q) 

<int : segment- numb er > 
<char-array : status-codes> . 

<char-arr ay : status-codes> = <int : number- of -cod es> 

[ <code> ... J T ~~~~ 

<code> = (A) or (D) or (H) or (I) or (M) 
or (P) or (S) or (V) or (X) . 

PARAMETERS 

Segment-Number (-3 to +32767) . Numbers from 1 to 3276? 
specify particular segments (which must already have 
been defined) . Zero refers to the crosshair cursor. 
Minus one means "all segments in the range from 1 to 
32767*" Minus two means "the default values for 
segments not yet defined . " Minus three means "all 
segments in the current matching class . " 

Status-Codes. The status codes tell which informaton 
is to be returned for the specified segment . A = 
"segment classes , " D = "detectability , " H = "high- 
lighting mode , " I = "image transform parameters , " M = 
"segment writing mode , " P = "pivot point for the 
segment , " S = "segment display priority , " V = "visi- 
bility ," and X = "segment position . " 



Description 

The <report-segment-status> command causes the 4110 to send 
a < segment- status-report> to the host computer . 

When the terminal sends a report to the host , it enters 
bypass mode . ( See <enter-bypass-mode> . ) 

This command is intended to be issued by the host computer . 
It should not be typed by the operator with the terminal in 

LOCAL mode. 



4110 SERIES COMMAND REFERENCE REV, DEC 1 981 



4-273 



ALPHABETICAL LISTING 



Segment Number . The first parameter in the <report-segment- 
status> command is an <int> specifying the segment number. 
If this is a number in the range from 1 to 32767 , then the 
< segment- status-report> includes information about that one 
specified segment* If this parameter is , then the Seg- 
ment- status-report> reports information ( position , 
visibility , etc . ) about the crosshair graphics cursor. If 
the parameter is -1 , then the < segment- st a tus-report> in- 
cludes information about all segments in the terminal's 
memory . If this parameter is -3 , then the report contains 
information about those segments in the current segment 
matching class . 

Segment Information Codes* The second parameter in the 
< report- segment- status> command is a <char-array> specifying 
which information about the segment ( or segments) is to be 
reported . Each type of information is represented by an 
uppercase letter in this <char-array> , as shown in Table 4- 
14. If the <char-array> is empty (has a count of zero) , then 
the only information in the <segment-status-report> will be 
the segment number (s)". 
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Table 4-14 



SEGMENT INFORMATION CODE/ ATTRIBUTES 



BCharacter in 
<Char-Array> 


Corresponding Attribute 
of the Segment 


A 


Segment classes to which 
the segment belongs 


D 


Detectability of the seg- 
ment 


H 


Whether the segment is 
highlighted 


I 


Image transform parame- 
ters 

(X- scale, y- scale , 
rotation, position) 


M 


Segment writing mode 


P 


Pivot point 


S 


Display priority 


V 


Visibility 


X 


Position 



For information about the format of reports which the 
terminal sends to the host in response to this command , see 
the description of the <segment-status-report> , elsewhere in 
this section . 
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Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 None None 

2 None None Empty string 
Errors 



SQ10 (Level 2) : Segment does not exist . 

SQ11 (Level 2): Invalid segment number (must be in the range 

-3 to +32767). 

SQ21 (Level 2): Invalid array of codes, (Must include only 

the uppercase letters A, D , H , I, M , P , S , 
V, and X.. Also , the array count must be in 
the range from to 32767. ) 



SQ22 (Level 3): Parameter 2 memory error . ( Out of memory 

while parsing the ar ay-of-codes <char-ar- 
ray> . ) 



Ref er ences 



<Arr ay> parameter types... 

< Segment- status- re port> syntactic construct . 
<Se-t-segment-class> command. 
<S.et-segment-det : ectabiiity> command . 
<.S'et-se.gment-highlighting>. command, 
<Set-segment-image-transform> command . 
<Set-segment-posit ion> command . 
< Set- segment- v isib il ity> command . 
< Set- segment-wr i ting-mod e> command . 
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< Report-Terminal-Sett ings> Command 



SYNTAX 

<report- terminal- set tings> = (ESC) (I) (Q) 

<inquiry-code> * 

< inquiry-code> = <char><char> . 

PARAMETERS 

Inquiry-Code. The two-letter op code for an escape- 
sequence command, or a special two- char act er inquiry 
code for other information about the terminal. (See 
the text for details.) 



Description 

This "general-purpose inquiry" command tells the terminal to 
send a < terminal- set ting s-report> to the host computer . 

When the terminal sends a report to the host , it enters 
bypass mode . ( See the description of the <enter-bypass-mode> 
command . ) 

<Char> Parameters* The two <char> parameters comprise either 
an op code for one of the terminal ' s commands or a special 
inquiry code . 

For instance , to inquire the terminal f s current baud rate 
settings , one would issue a < report- terminal- set tings> com- 
mand in which the two <char> parameters are (N) (R) . ( This is 
because the <set-baud-rates> command has the op code NR.) 



< report- terminal- set tings : baud rates> 
= <report- terminal- set tings : "NR"> 
= (ESC)(I)(Q)(N)(R) . 
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In response, the terminal sends a < terminal- setting s-report> 
to the host computer , in which it reports the current values 
of the parameters for the command whose op code was given in 
the < r epor t- terminal- set tings> command . 

For instance , the <terminal-settings-report> sent in re- 
sponse to a <report-terminal-settings : "NR"> command would 
report the terminal's current transmit and receive baud 
rates . 

Besides the op codes for commands , several special inquiry 
codes may be given in the <report-terminal-settings> 
command . These codes are listed in Table 4-15 . 
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Table 4-15 
SPECIAL INQUIRY CODES 



Code 


Meaning 


9M 

« i J 


xiiLjuxr c o nu w iiiuv^n 1 i tr t? in cinui y xo 

available. 


?T 


Inquires the terminal model. 


00 


x n v_j u x I " o one lxi in w a i c v cr i o iuii iiuniuci 

for the standard terminal • 


01 to QQ 


X ll U X 1 CO Oil" 1X1 111 W Cl 1 C V CI OlUll 11 Ullll UCI 

for optional firmware . (If the op- 
tion is not installed the terminal 
returns a zero for the firmware ver- 
sion number . ) 


01 


Option 1 (Extended Communications) 


04 


Options 4A, 4C, 4E, and 4F (Optional 

keyboards ) » 


10 


Option 10 (Three Port Peripheral 
Interface) 


1 3 


Ont ion 1 3 or 14 (Graohic Tablet) 


20 


4112 Option 20 - returns "1" if the 
option is (if the terminal is 
equipped with 3 bit planes) , and "0" 
is the option is not installed (if 
the terminal has only one bit 
plane) . 


21 


4113 Option 21 - returns " 1 " if the 

option is installed (if the terminal 
has 4 bit planes) , otherwise returns 
"0". 


42 


Option 42 or 43 (Disk Drive) 
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<Terminal-Settings-f*eport> . The < terminal- set tings-report> 

which the terminal sends in response to the <report-termi- 
nal-settings> is described under the heading "<Terminal- 
Sett ings-Report> . " 



References 

<Set-report~sig-chars> command . 

<Int-report> 

<Real-report> 

<Terminal-settings-report> 
<XY-report> 
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<Report-4010-Status> Command 



SYNTAX 




<report-401 0-status> = 


= (ESO(ENQ) . 


Description 




The <report-401 0-status> 

emulate a TEKTRONIX 4010 


command causes the 4110 terminal to 
Series terminal and send to the 



host a <4010-status-report> . 

The <4010-status-report> may take two alternate forms , de- 
pending on whether or not the terminal is emulating 4010 GIN 
mode . (The terminal is emulating 4010 GIN mode if it has 
received an <enable-40 1 0-GIN> command , but the operator has 
not yet pressed a key to initiate a <40 1 0-GIN-report> . ) See 
the description of the <401 0- statu s-report> for details . 

In the <4010-status-report> , a <40 1 0-xy-report> is included . 
This <4010-xy-report> includes the most significant ten bits 
of the x-coordinate , and the most significant ten bits of 
the y --coordinate , of some point in 4096-by-4096 terminal 
space • Since the least significant two bits of the x- and y- 
coordinates are omitted , the point in terminal space to 
which this <40 1 0-xy-repor t> refers cannot be determined 
precisely ; there may be an error of up to three terminal 
space units . 

The (ESC) (ENQ) command terminates <40 1 0-Style-GI> and re- 
turns the terminal to alpha mode . 

When the terminal sends a report to the host , bypass mode is 
entered . ( see enter-bypass-mode> . ) 



References 

<401 0-status-report> message type . 
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<Reset> Command 



SYNTAX 

<reset> = (ESC) (K)(V) . 



Description 

The <reset> command initializes the terminal to its power-up 
condition. It is equivalent to pressing the MASTER RESET 
switch, or turning the terminal off and then turning it on 
again. 

NOTE 

The terminal takes about 15 seconds to 
execute the <reset> command* During that 
time f it is performing its power-up re- 
set and self-test routines, and cannot 
process data coming from the host* 

Therefore, if you issue a <reset> com- 
mand from the host, you should wait 
about 15 seconds before sending other 
commands or data to the terminal . 



Defaults 



Since this command has no parameters , it has no default 
values . 

Errors 



There are no errors detected for this command . 
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RESTORE Key 4112, 4113 



Description 

The RESTORE key exists only in the 4112 and the 4113. It 
does not auto-repeat. 

The RESTORE key (the SHIFTed version of the VIEW key) lets 
the operator access the terminal's "memory" of windows - and 
framing boxes - previously used for the current view. 
Pressing this key restores current view's window and framing 
box to the size, shape, and position they had when the 
OVERVIEW or VIEW key was last pressed. (If the terminal is 
not in frame mode - that is , if neither the ZOOM light nor 
the PAN light is on - then the "restored" framing box will 
not be visible . ) 

If the current view is part of a view display cluster , then 
the RESTORE key affects all views in that display cluster . 
( See the description of the < set- view- cluster > command f or 
details . ) 

Only the window and framing box are restored . The RESTORE 
key will not replace segments which may have been deleted or 
made invisible ; nor will it change to other numbered views . 

Pressing the RESTORE key again restores the window and 
framing box to their conditions at a yet earlier time : the 
"next to last time" that the OVERVIEW or VIEW key was 
pressed . 

These "old values" for the window and framing box are 
preserved on a stack whose depth never exceeds three . Since 
there are no more than three "old" sets of values stored on 
the stack , you can always get "back to where you were" by 
pressing the RESTORE key no more than four times . 
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If the CTRL key is pressed together with RESTORE, then the 
original window and framing box are restored. This is the 
window that was created by the latest < set-window> command, 
and the framing box that existed when the ZOOM or PAN mode 
was first entered for this view. 

Window and framing box values are entered into the stack 
each time that the OVERVIEW or VIEW key changes a view's 
window. 



References 

OVERVIEW key. 
PAN key. 
VIEW key. 
ZOOM key. 
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<Runlength-Write> Command 4112, 4113 



SYNTAX 

<runlength-write> = (ESC) (R) (L) 

<int+-array : runcode-arr ay > . 

PARAMETERS 

Runoode-array • The runcodes in the runcode-arr ay can 
range from to 65535. Each runcode includes two 
numbers packed together: a color-index and the number 
of pixels which are to be set to that color-index . 



Description 

The <runlength-wr ite> command is one of two commands by 
which color-indices may be loaded into a fill pattern which 
is being defined or into the pixel viewport . ( The other 
command is the <r aster-wr ite> command . ) 

Runcode array* The < int-arr ay> parameter contains a number 
of runcodes . Each runcode is an integer into which are 
packed two numbers : a color-index to which a series of 
pixels ( a "run" of pixels) are to be set , and the number of 
pixels in that run . The packing scheme is as follows : 

runcode 

= (number-of-pixels) *(2**N) + (color-index) 

where 

N = number- of-b it s-per-pix el 
and where 

2**N = two-raised-to-the-power-N 
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If the <runlength-wr ite> command is part of a < f ill-pattern- 
definition^ , then the packing formula uses the " bits-per- 
pixel" parameter from the < beg in- f ill-pat tern> command that 
began that < fill-pat tern- definition^ Otherwise, the !f bits- 
per-pixel ?? parameter from the most recent <begin-pixel- 
oper at ions> command is used . 

However, there is an exception to this : if the <begin-pixel- 
operations> or < beg in- f ill-patter n> command specified six 
bits per pixel, the bits-per-pixel value in the packing 
scheme is three ( for the 4112) or four ( for the 4113). 

If number- of-pix els is zero , then no color-indices are 
loaded and the pixel beam position does not change . 

Loading the color-indices into Pixels* Starting at the 
current "pixel beam position" in the fill pattern rectangle 
or pixel viewport, the color-index for each runcode is 
loaded into L pixels , where L is the length of the run for 
that runcode . As each pixel receives a color-index , the 
pixel beam position moves , so that it points at the next 
pixel to the right on the same line. On encountering the 
right edge (of the fill paittern rectangle or pixel 
viewport) , the pixel beam position "wraps around" to point 
to the leftmost pixel ori . the "line . below. When all the pixels 
for a given run have been loaded with the color-index f or 
that run , the process is repeated f or the next runcode in 
the < int-arr ay> . 

NOTE 

It is possible to build very long run- 
code arrays , so that the <runlength- 
write> command requires an inordinately 
large number of characters to transmit 
it to the terminal . On some hosts , this 
may exceed a "maximum line length 11 for 
transmissions from the host computer . 

Should this problem be encountered , the 
remedy is to split the <runlength-write> 
command into several such commands , so 

that each command fits within the maxi- 
mum line length. 
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Too Many Color-Indices. If too many color-indices are sent 
in the runcode array, so that the pixel beam position would 
move below the bottom of the fill pattern rectangle or pixel 
viewport, then one of two things can happen: 

If the <runleng th-wr it e> command is part of a < f ill- 
pattern-definition>, that <fill-pattern-definition> 
ends when all the color- ind ices for the fill pattern 
have been specified. There is no need, in this case, 
for an < end- fill- patter n> command. (Such a command, if 
received, will be ignored.) Excess color-indices with- 
in the same <runleng th-wr it e> command are ignored. 

(Since the < f ill-pattern-def inition> has been termi- 
nated , subsequent < r aster-wr i te> and < run length- wr it e> 
commands will send their color-indices to the pixel 
viewport rather than to the fill pattern rectangle . ) 

If the < run leng th-wr it e> command is not part of a 
< f ill-pattern-def inition> , then it is send ing color- 
indices to the current pixel v iewpor t . In that case , 
the pixel beam posiition "wraps around" from the last 
pixel in the bottom row of the pixel viewport to the 
first pix el in the top row of that v iewpor t . 



Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 None None Empty array 
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<Save> Command 



SETUP Mode Name: SAVE 



SYNTAX 

<save> = (ESO(JMV) 

<str ing : thing-to-be-saved> 
<int : it em-number- or -count> 
<string : "TO" or empty str ing> 
<str ing : destination- specifier> . 

<str ing : thing- to-be- saved > = <str ing : "MAC"> 

or <string: "SEG"> 
or <string: "RAS"> 
or <string: "RUN"> . 

PARAMETERS 

Thing-To-Be-Saved • "MAC" means "save a macro defini- 
tion." "SEG" means "save a segment definition." "RAS" 
means "save the contents of the pixel viewport using 
<raster-write> commands . " "RUN" means "save the 
contents of the pixel viewport using <runlength-wr ite> 
commands . " ( The latter two codes do not apply to the 
4114 terminal.) 



Description 

The <save> command causes the terminal to save an item from 
its internal memory by sending a series of escape-sequence 
commands to the specified destination . Here , the "item" may 
be : 

A macro definition . 
A segment . 

In the 4112 and 4113 only , a series of pixels from the 
current pixel viewport . 
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The item is saved by sending a series of escape-sequence 
commands to the specified destination. That destination is 
typically a file on the terminal's internal disk drive; by 
<load>ing the file, the item saved can be created again in 
the terminal 1 s internal memory. 

FifSt Parameter, The <save> command's first parameter is a 
<string> of three letters. This must be: 



<string : "MAC"> = (3)(M)(A)(C) 

<string : "SEG"> = (3)(S)(E)(G) 

<string : "RAS"> = (3)(R)(A)(S) 

<string : "RUN"> = (3)(R)(U)(N) 



to save a macro 
definition 

to save a segment 
definition 

to save pixels from 
the 4112 or 4113 pixel 
viewport using (ras- 
ter-write) commands 

to save pixels from 
the 4112 or 4113 pixel 
viewport using (run- 
length-write) commands 

Second Parameter. The second parameter is of the <int> 
parameter type , representing an integer number . 

If a macro definition is being saved , this <int> is 
the macro number . Macro number -1 may be used to mean 
"all macro definitions . " 



If a segment is being saved , this <int> is the segment 
number . This must be in the range from -3 to -1 , or 
from +1 to +32767 . Positive segment numbers represent 
specific user-defined segments ; an error is detected 
if the specified segment has not been defined . Segment 
number - 1 means "all user-defined segments , " and seg- 
ment number -3 means " all segments in the current 
segment matching class . " Specifying segment -2 causes 
the terminal to save the default segment attributes 
for segments which have not yet been defined . 
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• If pixels from the 4112 or 4113 pixel viewport are 

being saved , this <int> specifies the number of pixels 
to be saved, starting at the current pixel beam 
position* If N pixels are to be saved, the pixel beam 
position is updated so that, ..after the <save> command 
has been executed, the pixel beam position is at the 
(N+1 ) th pixel . 

Specifying "minus one" for this parameter causes the 
entire pixel viewport to be <save>d . In this case, 
after the <save> command has been executed , the pixel 
beam position is restored to its position before the 
<save> command. 

Third Parameter . The third parameter is a separator 
<string>; this must be either the empty <string> ( count of 
zero) or the <string> for the word "TO , " as follows : 

<third-*°parameter> = <string : empty> or <str ing : "T0"> 

= (0) 

or (2)(T)(0) 



Fourth Parameter. The fourth parameter is a <str ing> speci- 
fying the destination for the escape-sequence commands which 
are being <save>d . 

Typically , this is a file on the terminal 1 s optional disk 
drive. Thus , <string : "F0 : MYSTUFF"> causes the item being 
saved to be recorded as a series of escape-sequence commands 
in the file named MYSTUFF on the disk volume inserted in 
disk drive zero. A <load : "F0 : MYSTUFF" > command can then be 
used to restore the item being saved to the terminal ' s 
internal memory . 

However , other destinations than disk files are allowed . 
Thus , <str ing : "HO: "> causes the item to be sent to the 
host as a series of escape-sequence commands, followed by 
the current <E0F-str ing> . 
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If the destination is the host computer, then the terminal 
inserts <EOM-indicator> s in the data being transferred to 
the host. An <EOM-indicator> is inserted after every N 
characters of data, where N is the maximum line length set 
in the most recent <set-report-max-line-length> command. 
(This feature is disabled if the report-max- line- length is 
set to zero,) Also, the terminal appends the current <EOF- 
str ing> to the end of the data being transferred. 

If the destination is an RS-232 peripheral port, the termi- 
nal appends that port's end-of-f ile string at the end of the 
data being transferred. (The port's end-of-f ile string is 
set by the < set- port- EOF- string> command.) 



NOTE 



If you issue a <save> command with the 
host computer as the destination , be 

sure to disable any echo which the host 

may be providing for characters typed 
from the terminal. If this is not done f 

the terminal interprets the echoed char- 
acters as commands to be executed f 
leading to undesired results. 

Again , <str ing : tf PA : " > causes those escape-sequence com- 
mands to be sent to RS-232 peripheral port number one . If a 
<port-assign> command has assigned a TEKTRONIX 4662 or 4663 
plotter to that peripheral port , then the commands are 
translated into appropriate commands for the plotter . ( See 
the description of the <plot> command for details . ) Thus , 
the <save> command can be used to draw an individual segment 
on a 4662 or 4663 plotter attached to the terminal 1 s 
optional three port peripheral interface . 

Contents of Files Created by the <Save> Command* The <save> 
command saves the specified information as a series of 
escape-sequence commands for the terminal . When those com- 
mands are executed , the item <save>d is recreated in the 
terminal f s internal memory . 
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When a macro definition is saved/ a <def ine-macro> command 
is sent to the destination device specified in the <save> 
command . 

When a. segment definition is <save>d, the following commands 
are sent to the destination device specified in the <save> 
command: 

• A series of commands to set default segment attributes 
for segments not yet defined: , <set-segment-high- 
lighting> , <set~pivot-point> , < set- segment- image- 
transform^ , etc . 

§ A <set-graphtext-precision : 1 > command , setting the 

graphtext precision to "string precision . " 

9 A <begin-segment> command for the segment specified in 

the <save> command 1 s second parameter . 

• A series of graphic primitives, and commands to set 
primitive attributes. These might include <enter-vec- 
tor-mode> commands , <xy> coordinates, <move>, <draw>, 
<dr aw-marker> commands , <set-line-style>. commands , 
etc . 

A An <end-segment> command to terminate the segment 
definition . 

Also , be aware that: 

• Alphatext is <save>d as string- precision grapht-ext. 

When a segment is subsequently <load>ed , it may change 
some of the command settings which were in ef f ect 

before the segment was <load>ed e To see the commands 
which are stored in the file created by a <save> 
command, put the terminal in snoopy mode and <load> 
the file. 
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NOTE 

Whan the file created with a <save> 
command is later used to <load> a seg- 
ment definition back into the terminal , 
the commands in that file will change 
the default segment attributes for seg- 
ments not yet defined, (This is because 
of the commands in the file which set 
the segment attributes for ff segment - 
2.") 



When pixels from the 4112 pixel viewport are saved , one or 
more <r aster-wr ite> or <run-length> commands are sent to the 
destination specified in the <save> command . 



Defaults 



Parameter 
Number 


As Shipped 
From Factory 


On Power-Up 


If the Parameter 

is Omitted 


1 


None 


None 


Error JV1 1 


2 


None 


None 


Error JV21 


3 


None 


None 


Error JV31 


4' 


None 


None 


Error JV41 



Errors 



JV1.1 (Level 2) 
JV12 (Level 3) 

JV20 (Level 2) 

JV21 (Level 2) 
JV31 (Level 2) 



Invalid type-of-save string . (Must be MAC , 
SEG, RAS, or RUN. The latter two codes are 
valid only for the 4112 terminal . ) 

Parameter 1 memory error . ( Out of memory 
while parsing paramter 1 , or while executing 
the command . ) 

The specified macro definition or segment 
does not exist . 

Invalid item number or count . 

Invalid separator string (must be empty 
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string or "TO") . 



JV32 (Level 3) 

JV40 (Level 2) 

JV41 (Level 2) 

JV42 (Level 3) 

JV43 (Level 2) 

JV49 (Level 2) 

References 



Parameter 3 memory error . ( Out of memory 
while parsing the separator string . ) 

The specified destination device does not 
exist . 

Invalid destination device specifier . 

Parameter 4 memor error. (Out of memory 
while parsing the destination string , or 
while executing the command . ) 

Parameter 4 context error. ( Not a valid 
destination device, or device is busy . ) 

Disk hardware error on destination disk 
drive . ( I/O error , drive not ready , or hard- 
ware write- protect error . ) 



<Copy> command . 

<EOF-str ing> syntactic construct . 
<Load> command . 
<Plot> command . 

<Set-current«matching-class> command . 
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<Segment-Status-Report> Massage Type 



< segment- st a tus~report> 

= [ < report- for -one- segment > . . . ] 
[< term- si g- char > ] 
<EOM-indicator> . 

<report-f or-one- segment > 

= [<EOM-indicator>] (See Note 1.) 

[ <sig-char> ] 

<int-report : s egment- number- or- err or- cod e> 

[< segment- at tribute- report> . . . ] 

[ <eom-indicator> ] . (See Note 2. ) 

< segment- a ttribute-report> 
= <segment-class-report> 
or <detectabil ity-report> 
or <highlighting-report> 
or < image-transf orm-report> 
or < writing-mode- report > 
or <pivot-point-report> 
or <displ ay-pr i or it y- report > 
or <visibility-report> 
or <posi t Ion- report > . 

<segment-class-report> 
= <char-report : " A"> 

< in t- array- report : class-number s> . 

<detectability-report> 
= <char-report : fT D" > 

<int-report : or 1 > . 

<highlighting-report> 
= <char-report : "H"> 

<int-report : or 1> . 

< image-transf orm-report> 
= <char-report : "I ff > 

<real-report : x-scale-factor> 
<r eal-report : y-scale-f actor > 
<real-report : rotation- in-d eg rees> 
<xy-r eport : posit ion> . 
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<wr i ting-mode- report > 
= <char-report : "M"> 

<int-report : 1 or 2> . 

<pivot-point-report> 

= <char-report : " P " > 

<xy-report : pivot-point> . 

<display-pr iority- report > 
= <char-report : !f S !f > 

<int-report : display- priority> . 

<visibility-report> 

= <char-report : "V"> 

<int-report : or 1 > . 

<posit ion-report> 

= <char-report : ff X"> 

<xy-report : position> . 



Not* 1® This <eom-indicator> is sent only if both 
these conditions are met : ( a) At least one character 
has already been sent on this line . (That is, at least 
one character has already been sent since the last 
< eom- indicator > . ) (b) Were this line not to be 
terminated now ( by sending the <eom-indicator> ) ■-, then 
this <report-for-one-segment> would cause the maximum 
line length to be exceeded. 

Note 2. This <eom-indicator> is sent only if the most 
recent <set-report-eom-f requency> command specified 
"more frequently 1 * rather than "less frequently. 11 
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Description 

The terminal sends a <segrn en t- status- re port> to the host 
computer in response to the < report- segment- status> command. 
When the terminal sends a report to the host, it enters 
bypass mode. (See <Enter- bypass-mode> , ) 

Overall Syntax* The < segment- status-report> consists of zero 
or more <report-for-one-segment>s , followed by a <term-sig- 
char> and an <eom-indicator> . 

<Tarm»Sig-Char> . The <term-sig-char> is determined by the 
most recent < set- r eport-sig- char s> command for non-GIN re- 
ports . ( See the description of the < set- r eport-sig- char s> 
command for details . ) The < term-sig-char> is provided as a 
convenience for the host routine which parses the <segment- 
status-report> ; it serves to mark the end of the report . 

If the <term-sig-char> is (NUL) , it is omitted from the 
<segment-status-report> . However , setting the <term-sig- 
char> to (NUL) would be unwise ; the host applications 
program probably needs the < term-sig-char> to tell when it 
is done parsing the < segment- st a tus-report> . 

Final <Eom-Indicator> • After sending the <term-sig-char> , 
the terminal ends the < segment- status-report> with an <eom- 
indicator> . This <eom-indicator> is always sent ; it helps to 
ensure that the host applications program receives the 
preceding characters in a timely manner . ( In most host 
operating systems , the user program does not actually re- 
ceive a message from the terminal until the message ends 
with a (CR) .) 
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<Report~for-One-Segment> • Each < report- for-one-segment> de- 
scribes the attributes for one segment,, 

The <report-for-one- segment > may begin with an optional 
<eom-indicator> . This <eom- indie ator> is provided because of 
the terminal 1 s "maximum line length" feature* (See the 
description of the <set-report-max-line-length> command for 
details . ) If too many characters have already been sent on 
the current line,, so that sending the remainder of the 
<report-for-one-segment> would cause the maximum line length 
to be exceeded , then the terminal ends the current line with 
an <eom-indicator> . The <sig-char> that follows would then 
be the first character of the next line of text . 

The <sig-char> is provided as a convenience for the host 
program' s parsing routine . It serves to mark the beginning 
of each <report-for-one-segment> . The <sig-char> is a single 
ASCII character, determined by the most recent <set-report- 
sig-char s> command for non-GIN reports . ( See the description 
of that command for details.) If the <sig-char> is ( NUL) , it 
is omitted . . ■ ■ 

After the <sig-char> comes an <int-report> : the segment 
number (or error code) for the particular segment whose 
attributes are being reported . If the <char-array> parameter 
in the < report- segment- st a tus> command was empty , then the 
segment number is the only item reported in the <report-for- 
one-segment> . An error code ( described later) is substituted 
for the segment number if an invalid segment number or 
segment attribute code, or if the segment specified does not 
exist . 

Following the segment number , each <report-for-one-segment> 
contains zero or more < segment- at t r ibute-report> s . There is 
one < segment- attribute-report> for each letter in the <char- 
array> parameter of the <report-segment-status> command . 

Each <segment-attr ibute-report> contains information about 
one of the segment 1 s attributes , and begins with the code 
letter for that attribute . For instance , a < segment-classes- 
report> begins with the letter A, <visibility-report> begins 
with the letter V , and a <position-report> begins with the 
letter X 
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Errors 

If the < report- segment- st atus> command specified an invalid 
segment number, a segment number for a segment which does 
not exist, or an invalid code letter for a segment attrib- 
ute, then the <segment-status-report> sent back to the host 
includes an error code* In that case, the < report- for-one- 
segment> has the special error code in place of the segment 
number, and there are no < segment- at t r ibut e- r epor t> s . Table 
4-16 lists these special error codes. 

Table 4-16 

ERROR CODES IN <SEGMENT-STATUS-REPORT>S 



"Segment Number" 
Error Code 


Meaning 


-32767 


The segment number 
in the Report- 
segment- st at us> was 
invalid . 


-32766 


The < report- segment- 
status> command 
specified a segment 
number for a segment 
which does not ex- 
ist . 


-32765 


The < report- segment- 
status> command in- 
cluded ( in its 
<char-array> ) a let- 
ter which is not a 
valid segment at- 
tribute code . 
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In addition to the error information in the < segment- status- 
report> , type SQ10, SQ1 1 , and SQ21 errors are detected in 
the terminal. These error codes will be sent to the host if 
a <report-error s> command is issued. (For details , see the 
descriptions of the <report-error s> command and the <errors- 
r eport> syntactic construct.) 



Ref erences 

<char-report> 
<int-r eport> 
<report-error s> 
<report- segment- st a tus> 
<set-report-sig-chars> 
<xy-report> 
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<StltQt-»Alphatext-Size«-Group> Command 4114 



SETUP Mode Name: ASIZEGROUP 



SYNTAX 

<select-alphatext-size-group> r(ESC) (M) (Y) 

<int : group> 

PARAHETERS 

Group (0 Of 1 ) . Selects between 4014 alphatext size 
group and 4016 alphatext size group* 

= 4014 alphatext size group 

1 s 4016 alphatext size group 



Description 

The <select-alphatext-size-group> commaaC modifies the ef- 
fect of the <set-4014-alphatext~size> command so that both 
4014 and 4016 character sizes can be emulated . 

Table 4-l6a summarizes how alphatext sizes change when 

different alphatext size groups are assigned . 

Table «-16a 
PRE-DEFINED TEXT SIZES 



<set- 

alphatext- 
size-group> 
<int : group> 


<set-4014- 
alphatext- 
size> setting 


<set- 

alphatext- 
size> <int>s 


Characters 

per 

Line 


Lines 

per 

Page 


or 1 


(ESC) (8) 


10, 6, 28 


74 


35 


or 1 


(ESC)(9) 


9, 6, 28 


81 


38 





(ESC) ( : ) 


6, M, 17 


121 


58 


1 


(ESC) ( : ) 


5, 6, 18 


133 


64 





(ESC)(;) 


5, 6, 18 


133 


64 


1 


(ESC)(;) 


4, 3, 12 


179 


76 
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Defaults 



Parameter 

Number 



As Shipped 
From Factory 



On Power«Up 



If the Parameter 
is Omitted 







Remembered 







Errors 



MYOO (Level 0): Invalid command (terminal is not a 4114). 
MY 1 1 (Level 2): Invalid value (must be either or 1 ) . 
Re f erences 

<Set-alphatex t-size> command . 

<Se t-4014-alphatext-size> command • 
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<Seleot-Fill-Pattern> Command 4112, 4113 



SYNTAX 

<select-fill-pattern> = (ESC)(M)(P) 

<int : fill-pat tern-number > . 

PARAMETERS 

Fill-Pittern-Number (-332768 to 32767). Numbers from 1 
to 32767 represent specific fill patterns . Of these , 
patterns 1 to 1 6 are predefined , while patterns 17 
through 32767 exist only if defined by the user . Zero 
and negative numbers represent fill patterns which 
consist entirely of the corresponding color-index . 
(Thus pattern number -7 is a pattern which is entirely 
color-index 7 . ) In the 4112, numbers from -8 to -32768 
cause panels not to be filled. In the 4113, numbers 
from -16 to -32768 cause panels not to be filled . 
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Description 

This command selects the pattern used to fill the interior 
of panels. The pattern number can range from -32768 to 

+32767, as follows: 

, In the 4112, numbers in the range from -32768 to -8 
cause the interiors of subsequent panels to be left 
unfilled. In the 4113, numbers from -32768 to -16 
cause panels to be left unfilled . 

In the 4112, patterns -7 through each fill the panel 
with a single color-index. ( In the 4113, this range is 
from -15 to 0.) Pattern fills with color-index , 
pattern -1 fills with color-index 1, etc . 

§ Patterns 1 through 1 6 are pre-defined ; Figure 4-12 
shows examples of these fill patterns . Patterns 1 
through 16 may be redefined by the user; but if these 
patterns are deleted ( redefined with a height of 
zero), they will not revert back to the predefined 
patterns until the terminal is turned off or <reset> . 

ft Patterns 17 through 32767 are reserved for the user to 
define . 

In the 4112, the default is pattern number -7; in the 4113, 
the default is pattern number -15. 
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If a panel being filled occurs on a surface which has fewer 
bit planes than the "bit-per-pixel" value used to define the 
fill pattern , then the terminal uses only the high-order 
bits of each color-index in the fill pattern, (This is the 
same rule as that employed by <raster-wr ite> , <runlength- 
wr ite> , and <pixel-copy> commands,) 

In the 4112, the default fill patterns are defined with 
bits-per-pixel set to three; in the 4113, they are defined 
with bits-per-pixel set to four.. 

In a 4112, therefore, fill pattern ■ -;6 (which consists 
entirely of color-index 6 , binary 110) is displayed on a 
three-bit-plane surface as color-index 6 (binary 110) . But 
on a two-bit-plane surface , the same fill pattern is dis- 
played as color-index 3 (binary 11). Likewise , on a one-bit- 
plane surface, this fill-pattern is displayed as color-index 
1 (binary 1 ) . 

Likewise, in a 4113, fill pattern -10 consists of pixels 
which are all set to color-index 1 (binary 1010) . On a 
four-bit-plane surface , this is displayed as color-index 1 
(binary 101 ) . But on a three-bit-plane surface, this same 
fill pattern appears in color-index 5 (binary 101), while on 
a two-bit-plane surface it appears in color-index 2 (binary 
1 0). On a one-bit-plane surface , fill pattern -10 appears in 
color-index 1 (binary 1 ) . 



Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 4112: -7 41 12: -7 

4113: -T 4113: -1 
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Errors 



MPOO (Level 2): Unrecognized command . (The terminal is not a 

4112 or a 4113.) 

MP10 (Level 2): Specified fill pattern does not exist (has 

not been defined ) . 

MP 1 1 (Level 2) : Invalid fill pattern number (must be in the 

range from -32768 to 32767-) 

Ref er ences 

<Begin-fill-pattern> command . 
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<Select-Hardcopy«Interface> Command 



SETUP Mode Name: HCINTERFACE 



SYNTAX 

<select-hardcopy-interface> s (ESC) (Q) (D) 

<int: interf ace > 

PARAMETERS 

Interface (0 - 1 ) . Specifies which hardcopy interface 
is used when the terminal receives a <hardcopy> com- 
mand . 

= monochrome : the standard hardcopy interface , to 

which can be connected TEKTRONIX 4612 and 4632 
Video Hard Copy Units. 

1 = color : the Option 9 hardcopy interface , to which 

can be connected a TEKTRONIX 4691 Color Graphics 
Copier . 



Description 

The <select-hardcopy-interf ace> command selects the hardcopy 
interface that is used when the terminal receives a <hard- 
copy> command or a <401 0-hardcopy> command 9 or when the 
HARDCOPY key is pressed • This command chooses between the 
standard hardcopy interface and the Option 9 color hardcopy 
interface . This command is recognized only by a 4113 termi- 
nal with Option 9 installed . 



4113 

Option 9 



Defaults 

Parameter As Shipped On Power-Up If the Paraneter 

Nunber From Factory is Onitted 

1 Remembered 
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Errors 

QDOO (Level ) : Unrecognized command (Option 9 is not 

installed) . 

QD1 1 (Level 2): <Int> parameter out of range (0 and 1 are 

valid) . 

References 
<Hardcopy> command . 
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<Select-View> Command 4112, 4113 



SYNTAX 

<select-view> = (ESC) (R) (C) 

<int : view-number> . 

PARAMETERS 

View-Number (-1 to 64) • Numbers from 1 to 64 name a 
specific view. Zero means "the next higher-numbered 
view," while minus one means "the next lower-numbered 
view . " 



Description 

A view is defined by a set of viewing parameters and 
(possibly) a set of visible segments . There may be up to 64 
views defined and each one may be independent of the others . 
Only one view may be selected to be current at a time . Into 
this current view go all actions such as unretained 
graphics , segments made visible , renew commands , etc . When a 
new view is designated as current , the attributes of the old 
view are remembered until the next time that view is 
selected . 

The <select-view> command specifies which view will be the 
current view. If the view has never been selected before , a 
new view (with the specified view number) is created . 

Creating a New View. When a new view is created in this 
manner , the view's parameters are set as follows : 

Window: The window for the new view is the same as that 

for the old view. (That is , it has the same 

lower-left and upper-right corners in 4096-by- 
4096 terminal space . ) 

Viewport : The viewport for the new view is on the same 

surf ace , and has the same lower-left and upper- 
right corners , as the viewport for the old view. 



4-306B 



ADD.N0V1982 41 1 SERIES COMMAND REFERENCE 



ALPHABETICAL LISTING 



Surface: The surface on which the viewport is displayed 

is the same as that for the old view . ( It can be 
changed with the <set-view-attributes> command . ) 

Segments : All segments which already exist remain in 

existence . However , none of these segments is 
visible in the new view. ( Segment visibility 
applies only to a particular view. See <set- 
segment-visibility> command . ) 

Indices : The new view's wipe index and border index are 
the same as those for the old view. ( These 
indices , and the surface number , can be changed 
with a <set-view-attributes> command . ) 



Border ; 



The visibility of the new view's border is the 
same as for the old view. ( It can be changed 
with a < se t- border- vis ibil it y> command or the 

BORDER key.) 



Other View Numbers. Specifying view zero causes the 4112 or 
4113 to select the next higher -numbered view of the existing 
numbered views . If there is no higher -numbered view in 
existence , then the lowest- numbered view is selected . This 
method of selecting the next view is equivalent to pressing 
the NEXTVIEW key , except that the view' s border does not 
blink. 

Specifying view number minus one selects the next lower- 
numbered view of the existing numbered views . If no such 
lower-numbered view exists , then the highest- numbered view 
is selected . This method is equivalent to pressing CTRL- 
NEXTVIEW, except that the view' s border does not blink. 
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Default View* The "default view, " created on power-up (or on 
a < delete- view: -1> command) has the following attributes: 



View number : 1 
Window: X=0 to X=4095, 

Viewport: full screen 
Surface number : 1 
Border : invisible 
Graphic beam position: 
Background gray-level : 



Y=0 to Y=3127 
(0,3071) 

black (0% lightness) 



Def aults 



Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 1 1 



Errors 



RC00 (Level 0): Unrecognized command. ( The terminal is not a 

41 12 or a 41 13. ) 

RC11 (Level 2) : Invalid view number . ( Must be in the range 

from -1 to 64,) 

Ref erences 

<Delete-view> command. 
<Set-segment-visibility> command. 
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<Set-Alphatext-Font> Command 



SYNTAX 




<set-alpnatext-iont> = (ESC; <iont-code> . 




<font-code> 5. (SI) or (SO) . 




PARAMETERS 




Font-Code. The (SI) character selects the 
alphatext font. The (SO) character selects 
font, if the terminal is equipped with an 
board . 


standard 
the APL 
APL key- 



Description 

This command selects the font used for displaying alphatext 
on those terminals equipped with the APL keyboard, Option 
4E. (ESC) (SI) selects the standard ASCII font, while 
(ESC) (SO) selects the APL font. The selected font is used 
for alphatext in the dialog area and on the screen, as well 
as for "string precision" graphtex t . However , only the ASCII 
font is used in SETUP mode. 



Ref erences 

<Gr aphic-tex t> command . 

<Se t- graph text- precis ion> command . 
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<Set-Alphatext-Size> Command 4114 



SYNTAX 

<set-alphatext-size> = (ESC) (M) (Z) 

<int : size-multipl ier> 

< int : inter- char acter- spacing > 

< int : interline- spacing> • 

PARAMETERS 

Size-Multiplier ( 1 to 16) . Determines the size of the 
character . 

Inter-Character-Spacing (0 to 15). Horizontal spacing 
between ad j acent character eel Is . 

Interline-Spacing (0 to 15). Vertical spacing between 

one row of text and the next. 



Description 

The <set-alphatex t-si ze> command is valid only in the 4114 
terminal . 

This command determines the size of all subsequent alpha- 
text , and the horizontal and vertical spacing between adja- 
cent character cells . 

Figure 4-13 shows the meanings of the parameters . The first 
parameter is a multiplier of the basic character size , which 
is five un its wide and six units high in 4096 x 4096 
terminal space. The next two parameters specify , in terminal 
space un its , how far apart the character character cells are 
spaced horizontally and vertical ly . 
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3892-1 2 

Figure 4-13. Meaning of <Set-Alphatext-Size> Parameters. 
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NOTE 

The width and height of the dialog area 
viewport are specified by the number of 
characters per line the number of lines 
in view* Therefore, changing the alpha- 
text character size will also change the 
dialog viewport diemensions* (Changing 
the dimensions can also change the 
position of the dialog area 1 s lower left 
corner «) For details..* see the descrip- 
tions of the <set-dialog-area-chars> , 
<s.et-dlalog-area-l:ines> f and < sett-dia- 
log- area- posit ion> commands • 



Def aul ts 



Parameter 
Number 



As Shipped 
From Factory 



On Power- Up 



If the Parameter 
is Omitted 



1 

2 
3 

Errors 



10 

6 

28 



Remembered 
Remembered 
Remembered 



Error MZ11 







MZ00 (Level 0): Unrecognized command . (Terminal is not a 

4114.) 

MZ1 1 (Level 2) : Invalid size multiplier (must be in the 

range from 1 to 16). 

MZ21 (Level 2): Invalid inter-character spacing (must be in 

the range from to 15). 

MZ31 (Level 2): Invalid inter-line spacing (must be in the 

range from to 255) . 
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R eferences 

<Se t-40 1 4-alphatex t-size> command . 
<Set- dialog-are a- char s> command . 
<Set- dialog -are a- lines> command . 
<Set-dialog-area-position> command . 
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12, 41 13 



SYNTAX 

<set-background-eolor> 

= (ESO(TMB) 

<int : f irst-color-coordinate> 
<int : second -co lor- coord inate> 
<int : rETrS^^^ . 

PARAMETERS 

The three color coordinates are either HLS, RGB , or 
CMY coordinates, according to the color-specifying- 
mode in the most recent < set- color-mod e> command . 
Their valid range is from to 1 00, except for the hue 

coordinate in the HLS system, which can range from 
-32768 to +32767. 



Description 

The <set-background-color> command sets the color of the 
"background surface" which is behind all the transparent 
wr iting surfaces* 

Whenever the background color is set , the background gray 
level is set to an equivalent NTSC gray level • The conver- 
sion formula that relates gray level to color is : 

Gray level z . 30*(Red level) + .59*(Green level) + • 1 1*(Blue level) 

The resulting gray level value is always rounded to the 
nearest integer . 

Two other commands can be used to set the background color : 
< set-background-gray-lev el> and <set-sur f ace-color-ma^> . 
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MOTE 

If you specify a SUBTRACTIVE overlay 
mode in the <set-color~mode> command , 
then you should also specify a back- 
ground color of white (or some other 
light color) with the < set-background-* 
color> 9 <set-background-gray-level> 9 or 
< set-surf ace-color-map> command. 



Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 

2 

3 
Errors 



TB00 (Level 0) : Unrecognized command (4114 only) . 

TB11 (Level 2): Invalid first parameter . (If in HLS mode, 

must be in the range from -32768 to +32767. 
If in RGB or CMY mode , must be in the range 
from to 100.) 

TB21 (Level 2) : Invalid second parameter (must be in the 

range from to 1 00) . 

TB31 (Level 2): Invalid third parameter (must be in the 

range from to 1 00) . 



References 

<Set-background-gray-level> command . 
<Set-color-mode> command . 
<Set-sur face- color-ma p> command . 
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<Set-Background-Gr ay-Lev el> Command 4112, 41133 



SYNTAX 








<set- bac kg round-gray - 


level> 


= (ESO(R)CB) 

<int : gray-level> , 




PARAMETERS 








Gray-Level (0 to 100) 
which the background 
set . Zero represents 
white . 


• The 11 

( behind 
black , 


per cent of lightness" 
all writing surfaces) 
while 100 represents 


to 
is 



Description 

This command determines the gray level used on the screen 
for background . It is the value of the screen when no object 
or opaque view objects are present . 

Initial value is "0% lightness , 11 or black . Maximum value is 
11 1 00% lightness or white . 

Please read the discussion of the gray levels and gray 
indices and their meanings and assignments, included in the 
description of the <set-sur face- gray-lev el s> command. 
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D efaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 Remembered 

Errors 

RBOO (Level 0): Unrecognized command. (The terminal is not a 

4112 or a 413.) 

RB11 (Level 2): Invalid gray level (must be in the range 

from to 1 00) . 

References 

<Se t-sur f ace- gray-lev el s> command . 
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<Set-Background~Indices> Command 



*112 t 4113 



SYNTAX 

<set-background-indices> 

= (ESC) (M) (B) 

<int : tex t- background -ind ex > 
<int: dash-gap-index> • 

PARAMETERS 

Teit«Background-Indei (-2 t© 32767) • Specifies the 
background index for string- precis ion graphtext and 
alphatex t which is not d ispl ayed in the d ialog area . 
(For such text in the d ialog area , see the <set- 
dialog-area-index> command . ) "Minus two " stands for 
the wi pe index for the current v iewport . "Minus one" 
ind icates "no index ; " the pixels in character back- 
grounds are left unchanged • Numbers from zero to 32767 
represent specific color ind ices . 

Dash-Gap-Index (-2 to 32767) • Determines the color 
index for the "gaps" in dashed lines • "Minus two " 
represents the wipe index for the current v iewport . 
"Minus one" indicates "no index ." Numbers from to 
32767 represent specific color ind ices . 



Description 

The <set-background-indices> command specifies the color- 
indices used for the backgrounds of string-precision graph 
text ( and alphatex t outsid e the d ialog area) . It also 
specifies the color-index used for the "gaps" in dashed 
1 ines . 

On a 4112, colors are represented as NTSC gray levels . The 
conversion formula that relates gray levels to colors is : 
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Gray level = . 30*(Red level) + . 59*(Green level) + . 1 1*(Blue level) 

The resulting gray level value is always rounded to the 
nearest integer . 

Index Minus Two • In this command , index minus two represents 
the wipe index for the current v iewport . Specifying index 
minus two for the text background index is like specifying 
"replace mode" in the < set-graphic s-area-wr it ing-mode> com- 
mand . 

Index Minus one* In the <set-background-indices> command , 
index minus one means "no index ." That is, it specifies that 
the character background (or dash gap) pixels are to be left 
unchanged . Specifying minus one for the character background 
index is 1 ike specifying "overstr ike mode" in the <set- 
graphic s-area-wr iting-mode> command . 



NOTE 

The <set-graphios»area-wr iting«-»mode> and 
< set-background- indices> commands both 
affect how alphatext is displayed in the 

graphics area* Thus, each of these com- 
mands supersedes the effect of the oth- 
er • 



Defaults 

On power-up , the text-background- index agrees with the re- 
membered value for the <set-graphics-area-wr i ting-mod e> 
command (GAMODE command) . If the GAMODE is REPLACE, the 
text-background index is -2; if GAMODE is OVERSTRIKE, the 
text text-backg round -index is -1 . As shipped from the facto- 
ry , GAMODE is OVERSTRIKE, so the text-background -index is - 
1. 

On power-up, the dash-gap-index is always -1 . 

If either parameter is omitted ( by terminating the command 
early) , that parameter is assumed to be zero. 
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Errors 

MBOO (Level 0): Unrecognized command. (4114 only). 

MB11 (Level 2): Invalid text-background-index (must be in 

the range from -2 to +32767) . 

MB21 (Level 2): Invalid dash-gap-index (must be in the range 

from -2 to +32767) • 

References 

<Se t- graphics- area- wr iting-mode> command. 
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<Set-Baud-Rates> Command 



SETUP Mode Name: BAUDR ATE 



SYNTAX 

<set-baud-rates> = (ESC) (N) (R) 

<int+ : tr ansmit-data-rate> 
<int+ : r eceive- data-rat e> . 

PARAMETERS 

Transm it-Data-Rate. The rate , in bits per second , at 
which the terminal transmits characters to the host 
computer . Valid values are 1 ( which means "external 

clock"), 50, 75, 110, 134, 150, 300, 600, 1200, 1800, 
2400, 4800, 9600, 19200, and 38400. 

Receive-Data-Rate. The rate at which the terminal 
receives characters from the host computer. Valid 
values are the same as for the tr ansmit-rate , with the 
addition of zero , which means "same as the tr ansmit- 
rate . " The 4112 and 4113 should not be set to more 
than 9600 bits per second . The 4114 should not be set 
to more than 1 9200 bits per second . 



Description 

Specifies the line data rates to be used for all subsequent 
communications . Spl it baud rates ( different speeds for 
receiving and transmission) are allowed . 

The receiving rate is the rate at which the terminal expects 
to receive data . The transmission rate is the rate at which 
ind iv idual characters are clocked out of the terminal . 

Valid values of the data rate parameters are : , 1 , 50 , 75, 

110, 134, 150, 300, 600, 1200, 1800, 2000, 2400, 4800, 9600, 
19200, and 38400 bits/second. 
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A receive baud rate of zero means that the terminal is to 
use the same receive speed as the transmission rate. A 
transmit rate of zero is invalid, 

A receive or transmit rate of one means that the terminal is 
to use an external clock to determine its data rate . (The 
external clock would be provided on the RECEIVE CLOCK or 
TRANSMIT CLOCK input of the RS-232 connector . ) 

In addition , you can specify a "transmit data rate 1 imit" 
with the <set-tr an sm it-rate- limit> command , and a transmis- 
sion delay time with the <set- tr ansmit-delay> command . These 
commands control the effective maximum speed for the termi- 
nal-to-host communications , which may be less than the rate 
at which the terminal sends each ind iv idual character . 

The baud rates may be set by the operator in SETUP mode , or 
they may be included as a <set-baud-rates> command in a file 
to be <load>ed from the terminal 1 s disk drive . It is usually 
unwi se to attempt to change the terminal ? s baud rates by 
command from the host computer . 
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NOTE 

The 4112 and 4113 can display simple 
alphanumerics and graphics only up to a 
maximum continuous data rate of 9600 
bits/second • For the 4114, this maximum 
rate is 19200 bits/second • (This does 
not include commands which require more 
than routine processing , such as the 
< include- co py-of-segment> or <load> com- 
mands • ) At higher data rates , some 
"handshaking" protocol must be used to 
prevent the terminal 1 s communications 
input queue from overflowing . 

Moreover , even at slow data rates , it is 
prudent to use a handshaking protocol . 
The terminal can take an appreciable 
amount of time to execute some commands 
- such as <load> or <save-segments : 
all> - which can be issued using only a 
very few characters. If a handshaking 
protocol is not used , the terminal 1 s 
input queue may overflow while executng 
such commands. 

Such a handshaking protocol might be as 
simple as issuing a <report-4010-status> 
command from time to time, and waiting 
to receive the reply before issuing more 
commands to the terminal . Alternatively, 
any of several data communications pro- 
tocols may be used : flagging mode , 
prompt mode , or block mode. Any of these 
communications modes will prevent the 
input queue from overflowing . 
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Def aul ts 



Parameter 
Number 

1 

2 



As Shipped 
From Factory 

2400 

2400 



On Power- Up 

Remembered 
Remembered 



If the Parameter 
is Omitted 

Error NR1 1 

Same as first 
parameter 



Errors 



NR11 (Level 2): Invalid transmit (terminal-to-host) data 

rate. (Must be 1 , 50, 75, 110, 134, 150, 
300, 600, 1200, 1200, 1800, 2000, 2400, 

4800, 9600, 19200, or 38400.) 

NR21 (Level 2): Invalid receive ( host- to- terminal ) data 

rate. (Must be 0, 1 , 50, 75, 110, 134, 150, 
300, 600, 1200, 1800, 2000, 2400, 4800, 
9600, 19200, or 38400.) 

References 

<Arm- for-block-mode> command . 
<Load> command . 
<Prompt-mode> command. 
<Set-f Iagging-mode> command . 
<Set-transfliit-rate~limit> command . 
<Set-transmit-delay> commands 
<Se t-port-baud-r ate> command. 
<Se t- queue- si ze> command. 
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<Set-Block-Continue-»Chars> Command (Option 01) 



SETUP Mode Name: BCONTINUECHARS 



SYNTAX 

< set- block-continue- char s> 

= (ESC) (0)(C) 

<int : transmit-continue-char> 
< int : receive- con tin ue-char> . 

PARAMETERS 

Transm it-Con tinue-Char (0 to 127). The numeric equiva- 
lent of the <continue-char> for <block>s transmitted 
from the terminal to the host. 

Receive-Con tinue-Char (0 to 1 27) . The numeric equiva- 
lent of the <continue-char> for <block>s received by 
the terminal from the host . 



Description 

Sets the <block-continue-char>s which signal the end of 
1 ines within a block ( other than the last line , which uses 
the < block- end- eh ar > ) . 

(This command is invalid if the terminal is already in block 
mode , or if it is armed for block mode . ) 

Explanation . In block mode , the syntax for each line ( other 
than the last 1 ine) of a block is: 

<block- l! other- than- la st"-line> = <block-header> 

<block-packed-data> 
<block-continue-char> 
<E0L-string> . 

The < block-continue- char > is used here to signal the end of 
the < block-packed- da ta> and to ind icate that there is yet 
another line of the block to come . 
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Def aul ts 

Parameter 
Number 

1 

2 

Errors 



As Shipped 
From Factory 

38 - (&) 

38 - (&) 



On Power-Up 

Remembered 

Remembered 



If the Parameter 
is Omitted 

- (NUL) 

- (NUL) 



OC00 (Level 2): Unrecognized command . (Option 1 is not in- 
stalled . ) 

OC03 (Level 2): Command is invalid at this time. (Terminal 

must not be in block mode or armed for block 
mode . ) 

0C1 1 (Level 2): Invalid first parameter . ( Must be in the 

range from to 127.) 

0C21 (Level 2 ) : Invalid second parameter . ( Must be in the 

range from to 127*) 



References 



<Block> syntactic construct, 



( 
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<Set-Block-End-Chars> Command (Option 01) 



SETUP Mode Name: BENDCHARS 



SYNTAX 

<set- block-end- char s> = (ESC) (0) (E) 

<int : tr ansmit-end-char> 
<int : r eceive- end- char > . 

PARAMETERS 

Transm it-End-Char (0 to 127) . Numeric equivalent of 
the <block-end-char> for <block> s sent from the 
terminal to the host . 

Receive-End-Char (0 to 127). Numeric equivalent of the 
<block-end-char> for <block>s received by the terminal 
from the host . 



Description 

This command , for use with block mode , sets the <block-end- 
char>s for blocks sent to and from the terminal . 

(This command is inv al id if the terminal is already in block 
mode , or if it is armed for block mode . ) 

Explanation . In block mode , the syntax for the last line of 
a block is: 

<block-last-line> = <block-header> 

<block-packed-data> 
<block-end-char> 
<E0L-string> . 



The <block-end-char> is used here to signal the end of the 
< block- packed-da ta> and to ind icate that there are no more 
1 ines of the block . 
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Defaults 



Parameter 
Number 



As Shipped 
From Factory 



On Power-Up 



If the Parameter 
is Omitted 



36 - ($) 



Remembered 







(NUL) 



2 



36 - ($) 



Remembered 







(NUL) 



Errors 



0E00 (Level 2): Unrecognized command. (Option 1 is not in- 
stalled . ) 

OE03 (Level 2): Command invalid at this time. (Terminal must 

not be in block mode or armed for block 
mode . ) 

0E11 (Level 2): Invalid first parameter. (Must be in the 

range from to 127.) 

0E21 (Level 2): Invalid second parameter . (Must be in the 

range from to 127.) 



References 

<Block> syntactic construct. 
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<Set-Block-Headers> Command (Option 01) 



SETUP Mode Name: BHEADERS 



SYMTAX 

<set-block-headers> = (ESC)(0)(H) 

<int-array : tr an sm it- header > 
<int-array : r eceive-header> . 

PARAMETERS 

Tr ansmit-Header . Numeric equivalents (range to 127) 
of up to ten characters. These characters comprise the 
<block-header> for <block>s sent from the terminal to 
the host . 

Receive-Header • Similar to the tr an sm it- header , but 
for blocks received from the host . 



Description 

Sets the transmit and receive header sequences for block 
mode . (Here, 11 transmit header" means the header sequence for 
blocks sent from the terminal to the host computer ; "receive 
header" means the header for blocks sent from the host to 
the terminal . ) Each header is specified as an < int-array> , 
where the < int>s in the array are the numeric equivalents of 
the ASCII characters in the header . There may be up to ten 
characters in each header . 

This command is invalid if the terminal is already in block 
mode or armed for block mode . 
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NOTE 



c 



You should use different strings for the 
transmit and receive block headers . Oth- 
erwise, echoes from the host of blocks 
which the terminal transmits would be 
interpreted by the terminal as blocks 
coming from the host program. 



Defaults 



Parameter 
Number 



As Shipped 
From Factory 



On Power- Up 



If the Parameter 
is Omitted 



HEADTX 



Remembered 



Empty array 



HEADRX 



Remembered 



Empty array 



( 
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Errors 



OH00 (Level 2): Unrecognized command . (Option 1 is not in- 
stalled . ) 

OH02 (Level 3 ) • Out of memory while performing <set-block- 

header s> command . 

0H03 (Level 2): Command invalid at this time . ( Terminal must 

not be in block mode or armed for block 
mode . ) 

0H11 (Level 2): Invalid character code (0 to 127) or array 

count ( must be in range to 1 0) in 
"transmit" ( terminal- to- host ) block header . 

OH 12 (Level 3 ) : Parameter 1 memory error . (Out of memory 

while parsing the < int-arr ay> . ) 

0H21 (Level 2): Invalid character code (0 to 127) or array 

count ( must be in range to 1 0) in "re- 
ceive" ( host- to- terminal ) block header . 

0H22 (Level 3 ) - Parameter 2 memory error . (Out of memory 

while parsing the < int-ar ray> . ) 

References 

<Block> syntactic construct . 
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<Set-Block-Length> Command (Option 01) 



SETUP Mode Name: BLENGTH 



SYNTAX 

<set-block-length> = (ESC)(0)(S) 

<int+: tr an sm it-block- length > 
<int+ : r eceive- block- length > . . 

PARAMETERS 

Transmit-Block-Length (5 to- 65535). Maximum. length of 

unpacked data in blocks which the terminal sends to 
the host. 

Receive-Block-Length (5 to 65535). Maximum length of 
unpacked data in blocks received from the host* 



D escription 

Sets the block lengths for transmitted and received blocks 
in block mode* (Here s 11 transmitted block" means a block 
which the terminal sends to the host; "received block 11 means 
a block which the host sends to the terminal,) 

The specified block length is the number of data bytes, 
including the four control bytes , before packing* The actual 
number of characters transmitted over the line will be 
greater beacause of the packing and fo rmatting overhead . 
(For more info rmation on the packing of data , see the 
description of the < set- b lock-pa eking > command . ) 

This command is invalid if the terminal is already in block 
mode , or if it is already armed for block mode. 



4-332 



rev, dec 1981 4110 SERIES COMMAND REFERENCE 



ALPHABETICAL LISTING 



Defaults 



Parameter 
Number 



As Shipped 
From Factory 



On Power-Up 



If the Parameter 
is Omitted 



256 



Remembered 



Error 0S11 



2 



256 



Remembered 



Error 0S21 



Errors 



OS00 (Level 2): Unrecognized command. (Option 1 is not in- 
stalled . ) 

OS03 (Level 2): Command invalid at this time. (Terminal must 

not be in block mode or armed for block 

mode.) 

0S11 (Level 2): Invalid terminal-to-host block length (must 

be in the range from 5 to 65535.) 

0S21 (Level 2): Invalid host- to- terminal block length (must 

be in the range from 5 to 65535.) 

Re f erences 

<Block> syntactic construct. 
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<Set-Block-»Line-Length> Command 
SETUP Mode Name: BLINELENGTH 



SYNTAX 



(Option 01) 



<set-block-line-length> = (ESC) (0) (L) 

<int+ : maximum-line- 

length> . 
PARAMETERS 

Maximum-Line-Length (12 to 65535). The maximum number 
of characters in each line of a <block> which the 
terminal sends to the host . 



Description 

The <set-block-line-length> command sets the maximum number 
of characters in each "line" of a <block> which the terminal 
sends to the host in block mode . 

When comparing the length of a 1 ine with this maximum line 
length , the "line length" includes the header characters , 
the characters of packed data , and the <block-continue-char> 
or < block- end- char > . Not included are the characters in the 
<eol-string> . (See <block> for details . ) 

You should choose a max imum line length which does not 
exceed the capacity of the host computer f s input buffer . 
That is , the line-length in the < set- block- line- length> 
command , plus the characters in the <E0L-string> , should not 
exceed the ho s t f s s input buffer size . 
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When the terminal sends characters in block mode, it counts 
the characters of packed data on each line as it sends them . 
When the character count reaches one less than the current 
block-line- length setting , the terminal ends the line by 
send ing the <block-continue-char> and the current <EOL- 
str ing> . 

This command is invalid if the terminal is already in block 
mode , or if it is already armed for block mode . 



Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 70 Remembered Error 0L11 

Errors 



OL00 (Level 2): Unrecognized command . (Option 1 not in- 
stalled . ) 

0L03 (Level 2): Command invalid at this time . (Terminal must 

not v be in block mode or armed for block 
mode . ) 

OL 1 1 (Level 2): Invalid maximum number of characters in 

line . ( Must be in the range from 1 2 to 
65535.) 

References 

<Block> syntactic construct. 
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<Set-Block-Master-Chars> Command (Option 01) 



SETUP Mode Name: BMASTERCHARS 



SYNTAX 

< set- block-mas ter-chars> = (ESC) (0 ) ( M) 

<int : t ran sm it- master - char >. 
< int : r eceive-master- 

char > . ■ 
PARAMETERS 

Transm it-Master-Char (0 to 127)* The numeric equiva- 
lent of the <b lock-mas ter-char> for <blocks> sent from 
the terminal to the host . 

Recei've-Master-Char (0 to 127)* The numeric equivalent 
of the <block-master-char> for <block>s received from 
the host. 



Description 

Sets the master characters for block mode transmission and 
reception . 

This command is used in conjunction with the <set-block-non- 
xmt-chars> command* When the host or terminal would other- 
wise have occasion to send one of ■ the' non-transmittable 
characters , it sends instead the "master character , " fol- 
lowed by another character . This two-character combination 
substitutes for the non-transmittable character . 

This command is invalid if the terminal is already in block 
mode , or if it is already armed for block mode . 
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Defaults 



Parameter 
Number 



As Shipped 
From Factory 



On Power-Up 



If the Parameter 
is Omitted 



35 



(#) 



Remembered 



- (NUL) 



2 



35 



(#) 



Remembered 



- (NUL) 



Errors 



OM00 (Level 2): Unrecognized command. (Option 1 is not 

installed . ) 

OM03 (Level 2): Command invalid at this time . (Terminal must 

not be in block mode or armed for block 
mode . ) 

0M1 1 (Level 2): Invalid "transmit" ( terminal- to- host) master 

ehar code (0 to 127) . 

0M21 (Level 2): Invalid "receive" ( host- to- terminal ) master 

char code (0 to 127). 

References 

<Set-block-non-xmt-char s> command . 
<Se t- block- packing > command . 
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<Set-Block-Non-Xmt-Chars> Command (Option 01) 



SETUP Mode Name: BNONXMTCHARS 



SYNTAX 

<set-block-non-xmt-chars> = (ESC) (0) (N ) 

<int-array : transmit- 

char s> 

<int-array : r eceive- 

chars> . 
PARAMETERS 

Transmit-Chars. An <int-array> in which each <int> 
represents an ASCII character which may not appear in 
the <packed-data> of a <block> sent from the terminal 
to the host . Each <int> in the array must be in the 
range from to 127. 

Receive-Chars. Similar to the first parameter , but for 
<block>s received by the terminal from the host . 



Description 

Sets the non- tr ansmittable characters for the terminal to 
transmit and receive ( to and from the host) while in block 
mode . Whenever the terminal or host computer would otherwise 
send one of these characters wi thin the characters of packed 
data , it (the terminal or host) substitutes a two-character 
sequence : the "master character , " followed by a character 
which substitutes for the non- tr ansmittable character . 
The substitution characters are assigned as follows : for the 
first non- tr ansmittable character , the letter ( A) ; for the 
second non- tr ansmittable character , the letter ( B) ; etc . 
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The master character, block-continue character, and block- 
end character must not be allowed to occur within the 
characters of packed data. If the packing scheme (chosen 
with the < set- block- packing> command) permits this to occur , 
then those characters must be designated as "non- tr an sm it-ta- 
ble" characters . 

This command is invalid if the terminal is already in block 
mode , or if it is armed for block mode . 



Def aul ts 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 35 - (# ) , 36 - ($ ) Remembered Empty array 



38 



(&) 



2 



35 
38 



<#), 36 

(&) 



($) Remembered 



Empty array 
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Errors 



ON00 (Level 2) 
ON03 (Level 2) 

ON1 1 (Level 2) 



0N12 (Level 3) 



0N21 (Level 2) 



0N22 (Level 3) 



Unrecognized command. (Option 1 is not in- 
stalled.) 

Command invalid at this time. (Terminal must 
not be in block mode or armed for block 
mode . ) 

Inv al id character code or array count in 
list of terminal- to- host non-transmittable 

character s (The array count must be in the 
range from to 20 , and the character codes 
must be in the range from to 127.) 

Parameter 1 memory error . (Out of memory 
while parsing the < int-arr ay> . ) 

Invalid character code or array count in 
list of host- to- terminal non-transmittable 
characters . ( The array count must be in the 
range from to 20 , and the character code 
must be in the range from to 127.) 

Parameter 2 memory error . (Out of memory 
while parsing the <int-array> . ) 



R e f erences 

<Set-block-master-chars> command . 
<Set-block-packing> command . 
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<Set«»Block«»Packing> Command (Option 01) 



SETUP Mode Name: BPACKING 



SYNTAX 

<set-block-packing> = (ESC) (0) (P) 

< i n t : t ransm it- unpacked- bit s > 
<int : t ran sm it- packed-bit s> 
<int : r eceive- unpacked- bi ts > 
<int : receive-packed-bits> . 

PARAMETERS 

Tr an smit-Un packed-Bits (7 or 8 ) . The number of bits 
per byte of <unpacked-data> in <block>s sent from the 
terminal to the host . 

Transm it-Packed-Bits (6, 7, or 8 ) . The number bits per 
"pseudo-byte" in the <packed-data> of <block>s sent 
from the terminal to the host . 

Re ceive-Un packed-Bits (7 or 8 ) . Like tr ansmit-un- 
packed-bi ts , but for <block>s received by the terminal 

from the host. 

Receive-Packed-Bits (6 , 7 , or 8 ) . Like tr ansmit- 
packed-bits , but for <block>s received from the host . 



Description 

This command determines how characters to be sent in block 
mode are packed before being included among the "packed 
data" in a block . 

The command is inval id if the terminal is already in block 
mode , or if it is armed for block mode . 
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The command has four <int> parameters; the first two govern 
block mode transmissions from the terminal to the host 
computer, while the second two govern transmissions from the 
host to the terminal. 

The purpose of packing is to convert the full seven-bit 
ASCII character set ( or a set of eight-bit full binary 
bytes) into a reduced character set for transmission over a 
host/commun ic at ions system hav ing limited transmission capa- 
bility. 

Packing Scheme 

Converting to a Stream of Binary Bits . The data to be 
transmitted is considered to be a long string of 7-bit or 8- 
bit bytes 1 ayed " end to end , 11 fo rming one long str ing of 
b inary bits . The first bit is the high-order bit of the 
first byt e ; the last bit is the low-order bit of the last 
byte . 

Composing Pseudo-Bytes and then the Actual Characters To Be 
Transmitted . Next the str earn is divided into a series of 
"pseudo-bytes" of 6 , 7, or 8 bits each . An offset is added 
to each pseudo-byte , thereby converting it into a standard 
ASCII character ; Table 4-1 7 shows the offset which is added 
for each allowable pseudo-byte size : 
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Table 4-17 



PACKED PSEUDO-BYTE CHARACTERISTICS 



Number of 
meaninc f ul 

data bits per 
pseudo-byte 


Offset added 
to make a 
standard ASCII 
character 


Range of possible 
ASCII decimal 
equivalents for the 
characters transmitted 


6 


32 


32 to 95 

ASCII characters from 
(SP) to (_) 


7 





to 127 

Full ASCII character set 


8 





to 255 

Full eight-bit data bytes 



When the end of a block is processed , if there are not 
enough bits to fill out the last pseudo-byte , an appropr iate 
number of zeroes are, appended to the end of the stream of 
b its . On input , this padding is ignored . Note that padding 
is inserted only at the end of a block and not at the end of 
a line within a block . 
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An Example 

Suppose the following: 

The terminal is in block mode, and the block mode 
parameters are at their factory settings. That is, the 
■■'■''<block-contiriue-char> , <block-end-char> , and <block- 
master-char> are (&), ( $ ) , and (#), respectively; the 
non- tr ansmittable characters are ( # ) , ($), and ( &) , in 
that order; the terminal-to-host and host- to- terminal 
header strings are 11 HE ADR X 11 and "HEADTX; " (CR) is the 
only <EOM-char> ; the <EOL-str ing> is the single char- 
acter, (CR); the unpacked and packed " bits-per-byte 
settings are 7 and 6 , respectively . 

The host has just sent an odd-numbered block to the 
terminal , with ' the" end-of-message bit set . 

. The terminal 1 s operator types " BEGINJPROGR AM " and 

presses RETURN, 

Then the following occur s : 

1 a The charac ter s 

(B)(E)(G)(I)(N)(_)(P)(R)(0)(G)(R)(A)(M) (CR) , plus four 
<block-control-bytes> , compr ise the <unpacked-data> 
for a block. The (CR) - typed by pressing RETURN - is 
an <EOM-char> ; as such, it signals the terminal to 
compute the block control bytes , pack them into the 
current block, and send that block to the host . 
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2. The <unpacked-data> consists of the text "BE- 
GIN_PROGRAM" , the ( CR) character, and the four "con- 
trol bytes," as follows: 

character: (B) (E) (G) (I) (N) (_) 

binary: 1000010 1000101 1000111 1001001 1001110 1011111 

character: (P) (R) . (0) (G) (R) (A) 

binary: 1010000 1010010 1001111 1000111 1010010 1000001 

character: (M) (CR) (A) (NUL) (BEL) (F) 

binary: 1001101 0001101 1000001 0000000 0000 1 1 1 1000110 

The last four characters - (A) (NUL) (BEL) (F) - are the 
<block-control-bytes>; they are described elsewhere in 
this manual . 

3. The terminal regroups the stream of binary bits into 
six-bit pseudo-bytes, as follows: 

decimal: (33) (17) (24) (60) (38) (29) (3D 
binary: 100001 010001 011000 111100 100110 011101 011111 

decimal: (40) (20) (41) (60) (30) (37) (1) 
binary: 101000 010100 101001 111100 011110 100101 000001 

decimal: (38) (35) (24) (8) (2) (5) (42) 
binary: 100110 100011 011000 001000 000010 000101 101010 



4. Since the unpacked pseudo-byte size is 6, Table 4-17 
calls for an offset of 32 to be added to each pseudo- 
byte. This converts each pseudo-byte into an ASCII 
character in the range from (SP) to ( ): 



decimal : 


(65) 


(49) 


(56) 


(92) 


(70) 


(61) 


(63) 


binary : 


1000001 


01 10001 


01 1 1000 


101 1 100 


10001 10 


0111101 


0111111 


character 


: (A) 


(1 ) 


(8) 


(\) 


(F) 


(=) 


(?) 


decimal : 


(72) 


(52) 


(73) 


(92) 


(62) 


(69) 


(33) 


binary : 


1001000 


01 10100 


1001001 


101 1 100 


0111110 


1000101 


0100001 


charac ter 


: (H) 


(4) 


(I) 


(\) 


(>) 


(E) 


(!) 


decimal : 


(70) 


(67) 


(56) 


(40) 


(34) 


(37) 


(76) 


binary : 


01001 10 


100001 1 


01 1 1000 


0101000 


0100010 


0100101 


1001 100 


character 


: (F) 


(C) 


(8) 


("(") 


(SP) 


(/) 


{%) 



4110 SERIES COMMAND REFERENCE rev, dec 1 981 



4-345 



ALPHABETICAL LISTING 



5 . The <block~continue-char> , ( &) , occurs at the end of 
this sequence. Since it is a non- transmittal) le charac- 
ter, it is replaced by <block-mas.ter-char> ( C) , or (# 

) ( C) . This gives the following sequence of characters 
holding the packed data : 

<packed-data> = ( A) ( 1 ) (8 ) (\) ( F) (= ) ( ?) (H ) (4 ) (I ) ( \) 

(>)(E)( !)(F) (C) (8 )("(") (SP)(/) (#)(C) 

6 . The terminal composes and sends a one-line block using 
this <packed-data> : 

<block> = <block-header> 
<packed-data> 

< b lock- end- char > 
<EOL-string. 

= (H)(E)(A)(D)(T)(X) 

(A)(1)(8)(\)(F)(=)(?)(H)(4)(I)(\) 

(>)(E)( !) (F) (C) (8 )("(") (SP)(/) (#)(C) 

($) 

(CR) 

( Actually , the block is composed and transmitted "on 
the fly" - character by character - as the operator 
types the data on the keyboard. When he presses 
RETURN, the (CR) and block control bytes are packed 
and sent. Then the final characters of the block are 
sent : the <block-end-char> and <EOL-str ing> . ) 



Defaults 



Parameter 
Number 

1 

2 

3 

4 



As Shipped 

From Factory 

7 

6 

7 
6 



On Power-Up 

Remembered 
Remembered 
Remembered 
Remembered 



If the Parameter 
is Omitted 

Error OP 11 

Error 0P21 

Error 0P31 

Error 0P41 
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Errors 



OP00 (Level 2): Unrecognized command. (Option 1 is not 

installed . ) 

OP03 (Level 2): Command invalid at this time . ( Terminal must 

not be in block mode or armed for block 
mode . ) 

0P11 (Level 2): Invalid terminal- to- host un packed- bits- per- 

byte ( must be 7 or 8). 

0P21 (Level 2): Invalid terminal- to- host packed-bi ts-per- 
pseudo-byte ( must be 6, 7, or 8). 

0P3 1 (Level 2 ) : Invalid host- to- terminal unpacked-bi ts-per- 

byte (must be 7 or 8). 

0P41 (Level 2 ) : Invalid host- to- terminal packed-bi ts-per- 
pseudo-byte ( must be 6 , 7 , or 8 ) . 

References 

<Block> syntactic construct. 

< Bl ock- control- byte s> . 

<Set- block- continue -char s> command . 

<Se t- block- end- char s> command . 

<Set-block-headers> command . 

<Se t- block-master- char s> command . 

<Se t-block-non-xmt-char s> command . 

<Se t-EOM-char s> command • 

<Se t-EOL- string > command . 
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<Set-Block-Timeout> Command (Option 01) 



SETUP Mode Name: BTIMEOUT 



SYNTAX 

<set-block-timeout> = (ESC) (0) (T) 

<int+ : number -of- second s> . 

PARAMETERS 

Number-Of-Seco.nds (0 to 65535) . Dur ation of timeout 
period in seconds . Zero disables the timeout feature. 



Description 

In block mode, when the terminal sends a block to the host, 
it expects an "ACK" block to come back from the host . If the 
terminal does not receive that ACK within a certain period 
of time , it re- transmits the block. The < set- block -timeout> 
command determines how long the teminal waits before re- 
transmitted the block . 

If the < int+> parameter in this command is zero, then the 
"retransmit on timeout" feature is disabled. 

The timeout parameter should be set to a value which is 
longer than the maximum expected host response time. 
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Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 Remembered 

Errors 



OT00 (Level 2): Unrecognized command. (Option 1 is not in- 
stalled . ) 

0T1 1 (Level 2): Invalid timeout . ( Must be in the range from 

to 65535 seconds . ) 

Re f erences 
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<Set-Border-Vi sibil ity> Command 4112, 41 13 



SYNTAX 

<set-border- vi sibil it y> 

= (ESC)(R)(E) 

< in t : border- vi sibil it y-mode> . 

PARAMETERS 

Border-Visibility-Mode (0 to 2). Zero makes the border 
for the current view invisible. One makes the border 
visible. Two toggles the border: if visible, it be- 
comes inv isible ; if invisible , it becomes visible . 



Description 

The command is present only in the 4112 and 4113 terminal s . 
It controls the visibility of a border drawn around the 
current view's v iewpor t . 

If the <int> parameter is one , the current view is d ispl ayed 
with a border drawn around its viewport . The border is drawn 
as a solid 1 ine , , just within the viewport . It is drawn in 
the color-index spec if ied by the < set- vie w-attr ibutes> com- 
mand for that view. (If no < set- v ie w-attr ibutes> command has 
been issued , the border is drawn with the highest possible 
color- index for the sur face on which the viewport appears . ) 

The border is always drawn in "set" mode ( ALU mode 1 1 ) so 
that it overwr ites the pixels below it. The border is 
removed by writing over the border , again in "set" mode , 
with the background wipe index for the viewport . Thus 
turning the border on and off will erase any pixels on the 
border of the viewport . ( For a description of ALU mode 1 1 , 
see the <begin-pixel-operations> command . For a description 
of the background wipe index , see < set- vie w-attr ibutes> . ) 
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If the < in t> is zero , the border around the current viewport 
is made invisible. 

If the <int> is two, the border is toggled. That is to say, 
if the border is visible, it is made invisible; and if it is 
inv isible , it is made visible • 



Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

10 

Errors 



RE 00 (Level 0): Unrecognized command. (The terminal is not a 

41 12 or a 41 13. ) 

RE11 (Level 2): Invalid "border mode" parameter (must be 0, 

1, or 2). 

References 

<Beg in- pixel - operation s> command . 
BORDER Key. 
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<Set-Br eak-Time> Command 



SETUP Mode Name: BREAKTIME 



. SYNTAX 






<set-break- 


time> = (ESC) (N)(K) 

< : int+: break-time- in 


-mill isecond s> . 


PARAMETERS 






Break-Time- 
ration of a 
to be sent. 


In-Milliseconds- (0 to 65535) 
"break" signal. Zero causes 


. Appr ox imate du- 
no break signal 



Description 

This command sets the length of the BREAK function in 
milliseconds . The actual break time is as close as possible 
( that is , within 25 ms) to the value specified , determined 
by the terminal clock resolution. The default break time 
delay is 200 ms . 

When the BREAK Key is pressed , the terminal send s a "space" 
(as opposed to a "mark" , in tel egraph terminology) to the 
host computer . The " space" ( a po sitive voltage on the RS-232 
connector ! s TDATA 1 ine) lasts for a sufficient time that the 
host computer ( or the data communications equipment) will 
recognize that the terminal is not send ing a val id ASCII 
character « 

( In hal f- duplex- super v i so r mode , the BREAK Key causes the 
modem to stop sending its secondary carrier for the 
designated length of t ime . ) 

On almost all systems , a break t ime of 200 ms will work 
well . Use the < set- break- time> command to change the defaul t 
setting only if the 200 ms break time does not work well on 
your system. 
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The terminal remembers its break time setting even when 
turned off; thus , the < set- break- time> command need only be 
given when the terminal is installed, (In the vast majority 
of cases, the command need not even be given then, as the 
default 200 ms break time will suffice,) 

Setting a break time of zero effectively disables the BREAK 
key; this may be useful for host systems which do not 
tolerate breaks. 



De f aul ts 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 200 Remembered 

Errors 



NK 1 1 (Level 2): Invalid parameter, (Must be in the range 

from to 65535.) 

References 
BREAK Key 
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<Set-Bypass-Canc el-Char > Command 



SETUP Mode Name: BYPASSCANCEL 



SYNTAX 




<set- bypass- cane el - 


-char> = (ESC)(N)(U) 

< in t : b ypass- can eel -char > . 


PARAMETERS 




Bypass- Cancel-Char 
lent of the bypass 


(0 to 127)* ASCII numeric equiva- 
cancel character. 


Description 



The < se t-b ypass- cane el -char> command defines which ASCII 
character is to serve as the "bypass c ancel character" for 
r emov ing the terminal from bypass mode . If the char ac ter is 
set to ( NUL ) - ASCII numeric equiv alent of zero - then the 
bypass mode feature is d i sab led . 



The bypass cancel character should be set equal to the last 
character which the host send s the terminal as it echoes a 
1 ine of tex t to the terminal . 

For instance , suppo se that the current <E0M-char> is (CR); 
that the current <E0L-str ing> consists of the single charac- 
ter , (CR); and that the ho st computer echoes each ( CR ) as 
(CR)(LF). 
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Then as the terminal sends each 1 ine of text to the host , 
the last character in each 1 ine sent to the host is ( CR) , 
and the last character in the echo of each such 1 ine is 
(LF) . The (LF) character , then , should be selected as the 
<bypass-cancel-char> . Since the ASCII decimal equivalent of 
(LF) is 10, this can be done with a < set- bypass- cane el -char 
: 1 0> command : 

< set- bypass- cane el- char : 10> = (ESC) (N ) (U )<int : 10> 

= (ESC) (N)(U)(: ) . 

For more information on bypass mode , see <enter-bypass- 
mode> . 



Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 10 - (LF) Remembered - (NUL) 

Errors 



NU 1 1 (Level 2): Invalid numeric equivalent of bypass-cancel 

character . ( Must be in the range from to 
127.) 

References 

<En ter-bypass-mode> command . 
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<S«t«C©l©r-C©pier-Data«Res©luii©ri> Command 4113 

Option 9 



SETUP Mode Name: HCDATARES 



SYNTAX 

<set-color-copier-data-resolution> = (ESC) (Q) ( B) 

<int : bytes> 

PARAMETERS 

Bytes (1 ©r 2) » Specifies how many bytes of color 
resolution the data sent to a color copier will have. 

1 = 1 byte color resolution 

2 = 2 bytes color resolution 



Description 

This command sets the precision of the color resolution of 
the data sent from the terminal to the copier for each of 
three colors ; red , green , and blue (RGB), 

If you assign one byte of color resolution, data transfers 
are faster when the information is transferred using the 
<copy> command with a source <str ing> parameter of 11 SC or 
when a hardcopy is perfo rmed withon a 4113 with Option 9 
installed and the <set-hardcopy-»inter f ace> command set to 
the color hardcopy interface . Also , disk storage space is 
saved when data fo rmatted by the 11 SC source is stored . One 
byte of color resolution contains two bits of info rmation 
for each of the three colors . 

If you assign two bytes of color resolution , the color is 
more precisely copied from the actual terminal color when a 
hardcopy is perfo rmed ( with a <hardcopy> command , the HARD 
COPY key , or when the destination device is 11 HC : ft for either 
the <copy> or <spool> command). Two bytes of color precision 
contain four bits of info rmation for each of the three 
colors* 
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Defaults 



Parameter 

Number 



As Shipped 
From Factory 



On Power-Up 



If the Parameter 
ia Omitted 



Remembered 



Error QB11 



Errors 



QBOO (Level 0): Unrecognized command (Option 9 is not 

installed) . 

QB11 (Level 2): <Int> parameter omitted or out of range d 

and 2 are val id) • 

References 

<Copy> command . 
<Hardcopy> command . 

HARD COPY key. 

<Set-hardcopy-inter f ace> command . 
<Spool> command . 
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<Sei-Color-Mode> Command 



4112,4113 



SETUP Mode Name: CMODE 



SYNTAX 

<set-color-mode> 



(ESC) (T)(M) 

<int : color-specif ying-mode> 

<int : co^^ 

<int : gray-mode> . 



PARAMETERS 



Color-Specif ying-Mode (0 to 3) • 

= no change 

1 = RGB 

2 = CMY 

3 r HLS (the default) 
Color-Overlay-Mode (0 to 3) • 

= no change 

1 = OPAQUE 

2 = SUBTRACTIVE 

3 = ADDITIVE 

Gray-Mode (0 to 2) • 

= no change 

1 s COL; normal color operation (the default) 

2 = BW; displays color images in black and white 



Description 

This command sets three "color mode" parameters for the 4112 
and 4113 terminals . 

Color-Specif ying-Mode. The color-specif ying-mode parameter 
determines which of the RGB (red , green, blue) , CMY (cyan , 
magenta, yellow) or HLS (hue , lightness , saturation) system 
of color coordinates is used for specifying color mixtures 
in subsequent <set-sur f ace-color-map> and <set-background- 
color> commands. If this parameter is zero, or is omitted , 
the color specifying mode is left unchanged . 
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The default on power-up is "HLS." In the HLS system, colors 
are specified by hue , lightness , and saturation coordinates 
on the color cone . When turned on, the terminal is in HLs 
mode . See Append ix E for details about the HLS color co r e. 

The RGB system determines a color mixture by adding together 
dif f erent proportions of the additive pr imary colors : red , 
green , and blue 1 ight sources . The RGB system closely 
resembles the actual operation of the terminal 1 s color 
display hardware. 

The CMY system mixes d if ferent proportions of the subtr ac- 
tive primary colors : cyan , magenta , and yellow inks. The 
terminal 1 s CMY mode emulates the mix ing of the cyan , magen- 
ta , and yellow pigments used in many pr inting processes . 

Color-Overlay-Mode* The color-overlay-mode parameter speci- 
fies the behavior of the terminal 1 s wr iting surfaces. If 
this parameter is zero , the color overlay mode is left 
unchanged . 

In OPAQUE mode (mode 1), pictures drawn on a sur face are 
deemed to be opaque ; they obscure pictures drawn on surfaces 
behind them . When the terminal is turned on , it is in OPAQUE 
mode . 

In SUBTRACTIVE mode (mode 2) , pictures are drawn using 
transparent inks . The terminal behaves 1 ike a "light table ," 
in which transparent overlays are placed on top of a 
diffusing light source . 

MOTE 

If you specify the SUBTRACTIVE color- 
overlay mode in the <set-color-mode> 
command 9 then you should also specify a 
background color of white (or sone other 
light color) with the <set-background- 
color> or <set-background-gray-level> 
command . 

In ADDITIVE mode (mode 3), the images drawn on different 
surfaces act as if their colored inks were comprised of many 
small point light sources . Where colors on one sur face 
overlap with colors on another sur face , the 1 ight from the 
two surface 1 s 1 ight sources combine . For instance , a red 
object on one sur face and a green object on another sur face 
would combine to produce a yellow color where the two 
objects overlap. 
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Gray-Mode. The gray-mode parameter determines whether colors 
are displayed in color or in black and white. If this 
parameter is zero, or is omitted , the gray mode is left 
unchanged . COL mode (mode 1) causes the 4113 to operate 
normally as a color graphics terminal . When the terminal is 
turned on , it is in COL mode . BW mode (mode 2) causes colors 
to appear as shades of gray , according to the NTSC trans- 
form : 

Gray level = . 30*(Red level) + .59*(Green level) + • 1 1*(Blue level) 

The resulting gray level value is always rounded to the 
nearest integer • 

The 4112 terminal ignores this parameter and always inter- 
prets color commands as if it is in BW mode . 



Defaults 



Parameter 


As Shipped 


On Power-Up 


If 


the Parameter 


Number 


From Factory 




is 


Omitted 


1 


3 (HLS) 










2 


1 (OPAQUE) 










3 


1 (COL) 











Errors 

TMOO (Level 0) : Unrecognized command (4 114 only) . 

TM11 (Level 2) : Invalid color-specif ying-mode (must be in 

the range from to 3) • 

TM21 (Level 2) : Invalid color-overlay-mode (must be in the 

range from to 3) • 

TM31 (Level 2) : Invalid gray-mode (must be 0, 1, or 2). 
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References 

Appendix E , "Color Coordinate Systems." 

<Se t- background- co lor > command . 
<Set-background-gr ay-lev el> command. 
<Set-sur f ace-def initions> command • 
<Set-sur f ace-color-map> command • 
<Set-sur f ace-pr ior ities> command . 
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<Set-Current-Matching-Class> Command 



SYNTAX 

<set-current-matching-class> 



PARAMETERS 



(ESC) (S)(L) 

< in t- array : 

< int-arr ay : 



inclusion-arr ay > 
exclusion-arr ay> 



Inclusion-Array . Lists the segment classes to which 
segments in the current matching class must belong . 
Class numbers in this array must be in the range from 

1 to 64. 

Exclusion-Array* Li sts the segment classes to which 
segments in the current matching class must not be- 
long . Val id class numbers are in the range from 1 to 

64, 



Description 

This command determines which segments are to be includ ed in 
the current 11 segment matching class . 11 ( In several command s 
r el at ing to segments , " segment -3 " means " all segments in 
the current segment matching class." 

For a segment to be includ ed in a "~3 " match , it must be a 
member of all classes 1 isted in the first < int-arr ay> 
parameter . Moreover , it must not be a member of any class 
listed in the second < int-arr ay> parameter . 

If a class number occur s in both s , then the current 
matching class is empty . 
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Def aul ts 



Parameter 
Number 



As Shipped 
From Factory 



On Power-Up 



If the Parameter 
is Omitted 



Empty array 



Empty array 



Empty array 



2 



Empty array 



Empty array 



Empty array 



Errors 



SL11 (Level 2): Invalid "include" segment-class array. 

( CI ass numbers must be -1, or in the range 
from 1 to 64. ) 

SL12 (Level 3 ) • Parameter 1 memory error. (Out of memory 

while parsing the "include" segment-class 
array . ) 

SL21 (Level 2): Inv al id " exclude" segment-class array * 

(Class numbers must be -1, or in the range 
from 1 to 64.) 

SL22 (Level 3 ) • Parameter 2 memory error . ( Out of memory 

while parsing the "exclude" segment-class 
array . ) 

Re f erences 

<Se t- segment- cl as s> command . 
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<Set»Dialog-Area-Buffer-Si ze> Command 



SETUP Mode Name: DABUFFER 



SYNTAX 

< se t- dialog- area- buffer- si ze> = (ESC) (L)(B) 

< in t : number-of-lines> 

PARAMETERS 

Number-Of-Lines (2 to 32767 ) . The number of full-width 
lines of text which will fit in the dialog area 
buffer . Here , "full width" means the width as set by 
the most recent < set- dialog -area- char s> command . 



Description 

This command set the buffer size for the dialog area . 
Suf f ic ient buffer space is reserved and initial ized to store 
<int> number of 1 ines of d ialog- tex t in memory. The width of 
the 1 ines ( max imum number of characters permitted in each 
1 ine) is set by <int> of the < set-d ialog- area- char s> com- 
mand . The number of 1 ines in the dialog area is set by the 
<set-dialog-area-lines> command . 

The value specified in the <int> parameter command take s 
effect when the dialog area is made visible . ( See <set- 
dialog-area-visibility>.) 



Defaults 



Parameter 
Number 

1 



As Shipped 
From Factory 

34 in 4112 
and 41 13; 
15 in 4114 



On Po wer-Up 

Remembered 



If the Parameter 
is Omitted 

Error LB 1 1 
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Errors 



LB11 (Level 2): Invalid number-of- lines parameter . ( Must be 

in the range from 2 to 32767 . ) 
(This error is only detected when the dialog area is next 
made visible.) 



Re f erences 

<Clear-dialog-ar ea> command . 
<Enable-dialog-area> command . 
< Se t- d ialog- area- char s> command . 
<Set- dialog- area- index> command . 
<Set-dialog-ar ea-lines> command . 
<Se t- dialog- area- posit ion> command . 
<Set- dialog- area- sur face> command . 
<Set-dialog-area-vi sibil ity> command . 
< Se t- dialog- area- wr iting-mode> command . 
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<Set-Di alog-Ar ea-Char s> Command 
SETUP Mode Name: DA CHARS 



SYNTAX 

<set-dialog-area-chars> = (ESC) (L ) ( C) 

< int : number-of-char s > . 

PARAMETERS 

Number-Qf-Chars . Maximum number of characters per line 
in the dialog area. In the 4112 and 4113, this must be 
in the range from 5 to 80 . For the 4114, it must be in 
the range from 5 to 819. 



SETUP Mode Name : DACHARS 



Description 



Sets the maximum number of characters in a 1 ine of the 
d ialog area . Thi s value take s effect when the dialog area is 
made visible. See al so the < se t-d ialog- ar ea-v i sib il ity> com- 
mand description in this section . 



The "max imum characters per line" parameter may not be less 
than five ; if a number less than five is spec if ied , the 
terminal sets this max imum line length to five. 

On a 4114, when a < set- dialog- area- char s> command decreases 
the number of characters allowed on each 1 ine of the dialog 
area , pr ev ious 1 ines already stored in the dialog area are 
not shortened to make them con form to the new < se t-dialog- 
ar ea-char s> setting . 
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Defaults 



Parameter 
Number 

1 



As Shipped 
From Factory 

80 in 4112 
73 in 4114 



On Power-Up 
Remembered 



If the Parameter 
is Omitted 

Error LC11 



Errors 



LC11 (Level 2): Invalid number of characters per line. (In 

the 4112 and 4113, this must be in the range 
from 5 to 80. In the 4114, it must be in the 
range from 5 to 819.) 

(This error is only detected when the dialog area is next 
made visible.) 



Re f erences 

<Se t- dialog- are a- visibility> command . 

<Er ase- dialog- area> command . 

<Set- dialog- area- buffer- si ze> command . 

<Set- dialog- area- index> command . 

<Se t- dialog- area- line s> command . 

<Se t- dialog- area- posit ion> command . 

<Se t-d ialog-ar ea- sur f ace> command . 

<Se t- dialog- area- wr i ting -mod e> command . 
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<Set«»Dialog-Area-Index> Command 4112, 41 13 



SETUP Mode Name: DA INDEX 



SYNTAX 

<set-dialog-area-index> = (ESC) (L) (I ) 

<int+: charac ter- index > 
<int+ : char- background- in- 
dex >. 

<int+ : wi pe- index> . 

PARAMETERS 

Character-Index (0 to 65535). The color-index with 
which characters are displayed in the dialog area. 

Char-Background-Index (0 to 65535) . The color-index 
wi th which the backgrounds of characters are 
d ispl ayed . 

Wipe-Index (0 to 65535) . The color-index used when 
erasing the dialog area . 



Description 

This command appl ies only to the 4112 and the 4113. 

This command sets the color- ind ices used in the dialog area. 
The first parameter specifies the color- index used to wr ite 
characters ; the second parameters specifies the color- index 
used to wr ite the backgrounds of those characters ; and the 
third parameter specifies the color- index used when erasing 
the d ialog area . 
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There is a maximum color-index for the surface on which the 
dialog area is located: one less than 2**M , where M is the 
number of bit planes assigned to that surface. (See the 
description of the < set- sur face- definition s> command for 
more information on assigning bit planes to surfaces.) 
color- ind ices greater than the maximum are treated as if 
they were equal to that maximum. 

Example. One way to show the operator the boundaries of the 
dialog area is to make characters typed there appear on a 
light gray background. 

Assume the following: (a) There is only one surface, which 
has three bit planes. That is, color- indices can range from 
to 7 on that surface, (b) The background gray level is 
"black" - 0% lightness; thus, pixels written in color-index 
("transparent") will appear black, (c) color-index 7 is 
set to "1 00% lightness ," and color-index 4 to "50% light- 
ness. " 

Under those assumptions , you can make the dialog area appear 
on an enhanced background by i ssuing the following command : 

<set- dialog- area- index : 7 , 4 , 4 > 

= (ESC) (L)(I)<int:7><int:4Xint:4> 
= (ESC)(L)(I)(7)(4)(4) . 

The command's three parameters (7 , 4 , and 4 ) have the 
following effects . Characters are d ispl ayed in color-index 7 
(white) . The background for each character cell is color- 
index 4 (50% lightness) . When the dialog scroll is erased , 
all its pixels are set to color-index 4 (50% lightness) . 

Wipe Index . When the dialog area is first made v isible ( by 
the < set- dialog- area- vi sib il it y> command or the DIALOG key) , 
the d ialog viewport is wiped. That is , all the dialog 
viewport pix el s are set to the current wipe index - the 
third parameter in the < set- dialog- index> command . Likewi se , 
whenever a new 1 ine of the d ialog area is created ( scrolls 
into view) , all that line's pixel s are set to the dialog 
wipe index . 
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Character Index , Character Background Index* When 'a charac- 
ter is typed into the dialog area, the character is written 
in the current dialog character index (the first parameter 
in the < set- dialog- index > command . The other pixels in that 
character cell are written in the current character back- 
ground index. (The second parameter in the command). 

Defaults* If no <set-dialog-index> command has been issued, 
then the character index is the maximum index for the 
surface on which the dialog area is located; the character 
background index and wipe index are color-index 0. 

Interaction with <Se t-Dialog-Wr iting-Mode> command . How 

characters are wr itten in the dialog area does not depend 
only on thi s command ; the < set-dialog-area-wr i ting-mod e> 
command al so has an effect . 



Def aul ts 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 4112: 7 Remembered 



4113: 1 



2 







Remembered 







3 







Remembered 
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Errors 



LI00 (Level 0): Unrecognized command. (The terminal is not a 

41 12 or a 41 13. ) 

L1 1 1 (Level 2): Invalid character index. (Must be in the 

range from to 65535.) 

LI21 (Level 2): Invalid character background index. (Must be 

in the range from to 65535.) 

LI 31 (Level 2): Invalid dialog area wipe index. (Must be in 

the range from to 65535.) 
(These errors are only detected when the dialog area is next 
made visible.) 

References 

< Set- dial og-area-visibility> command . 

<Er a se- dialog- area> command. 

<Se t- dialog- area- surf ace> command . 

<Se t- dialog- area- wr iting-mode> command . 

<Se t- sur face- definition s> command . 
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<Set-Dialog-Area-Lines> Command 



SETUP Mode Name: DALINES 



SYNTAX 

<set-dialog~area-lines> = (ESC) (L) (L) 

< in t : number-of-lines> . 

PARAMETERS 

Number-Of-Lines . The number of lines which are visible 
at once in the dialog area . In the 4112 and 4113, this 
must be in the range from 2 to 34 . In the 4114, the 
valid range is from 2 to 520. 



Description 

This command sets the maximum number of lines in the dialog 
area viewport . This value take s effect when the dialog area 
is made visible . 

On a 4114, because the terminal's refresh capability is 
1 imited , the total number of characters displayed in the 
d ialog area should be no more than about 800 . For this 
reason , the produc t of the max imum line size ( set with the 
< set-dialog-area-char s> command ) and the maximum number of 
1 ines in view ( set with the < set-dialog-ar ea-lines> command ) 
should be no more than about 800 . Otherwi se , the d ispl ay may 
f 1 icker annoyingly . If segments , as well as the dialog area , 
are being displ ayed in refresh mode , then this number should 
be reduced . 

Default. If no set-d ialog- lines command has been issued, the 
maximum number of 1 ines is five . 
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Defaults 



Parameter 
Number 



As Shipped 
From Factory 



On Power-Up 



If the Parameter 
is Omitted 



5 



Remembered 



Error LL11 



Errors 



LL11 (Level 2): Invalid parameter. (In the 4112 and 4113, 

must be in the range from 2 to 34. In the 
4114, must be in the range from 2 to 520.) 

Re f erences 
DIALOG key. 

<se t- dialog -area- vis ibil it y> command . 
<Se t- dialog- area- char s> command . 
<Se t-dialog-area-position> command . 
<Se t- dialog- area- buffer- si ze> command . 
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<Se t-D ialog- Area-Po-sition> Command 



SETUP Mode Name: DAPOSITION 



SYNTAX 

<set-d ialog -area- posit ion> = (ESC) (L ) (X ) 

<xy : 1 ower- left- cor ner> . 

PARAMETERS 

Lower-Left-Corner (X = to 4095, Y = to 4095) . 

Specifies the position on the screen of the d iaiog 
area T s lower-left corner . ( If the dialog area will not 
fit on the screen , the terminal adjusts this position 
so that the dialog area does fit.) 



Description 

Sets the lower left xy-coordinate po sition of the d ialog 
area . The si ze of the d ialog area , and therefore the upper- 
right corner of the dialog area on the screen , is determined 
by the most recent <set-dialog-area-lines> , < se t-dialog- 
ar ea-char s> , and < set- alpha text- si ze> command s . 

The terminal tr ys , so far as is possible , to fit the entire 
d ialog area on the screen . If necessary , the d ialog area 
will be re-positioned ( the x- or y-coordinate of its lower 
left corner decreased ) so as to fit the entire dialog area 
on the screen . 
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Def aul ts 



Parameter 
Number 



As Shipped 
From Factory 



On Power- Up 



If the Parameter 
is Omitted 



(0,0) 



Remembered 



(0,0) 



Errors 

No errors are detected for this command. 
References 

<Se t- dialog -area- 1 in es> command . 
<Se t-d ialog- area- char s> command. 
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<Set-Dialog-Area-Sur face> Command 



4112, 4113 



SETUP Mode Name: DASURFACE 



SYNTAX 

<set-dialog-area-sur face> = (ESC) (L) (S) 

< int : sur face-number> . 

PARAMETERS 

Surface-Number (4112: 1 to 3; 4113: 1 to 4). Specifies 
the wr iting sur face on which the dialog area is to be 
d ispl ayed . 



Description 

The sur face number identified is the one on which the dialog 
is to be wr itten . 



Defaults 



Parameter 
Number 



As Shipped 
From Factory 



On Po wer-Up 



If the Parameter 
is Omitted 



1 



1 



Remembered 



Error LS11 



4-374 



REV, dec 1981 41 10 SERIES COMMAND REFERENCE 



ALPHABETICAL LISTING 



Errors 

LSOO (Level 0): Unrecognized command. (The terminal is not a 

4112 or a 4113.) 

LS11 (Level 2): Invalid surface number . ( In the 4112, must 

be 1, 2, or 3; in the 4113, must be 1, 2, 3, 
or 4.) 

Re ferences 

<Se t-dialog-area-visibil ity> command . 
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<Set-Dialog-Area-Vi5ibil ity> Command 
SETUP Mode Name: DAVIS 



SYNTAX 

< se t- d ial og-area-vi sibil it y> = (ESC) (L) (V) 

< int : visibil ity- 

mode> • 
PARAMETERS 

Visibility-Mode (0 or 1). = NO; makes the dialog 
area invisible, 1 = YES ; makes the dialog area visi- 
ble . 



Description 

Making the Dialog Area Visible . If the < int> parameter is 
one , the contents of the dialog area scroll come into view, 

The d ialog area's size and position on the screen are 
governed by the most recent settings for the following 
command s : 

<set-dialog-area-buf f er-si ze> 
<set-dialog-ar ea-char s> 
<set-dialog-area-index> 

<set-dialog~-ar ea-lines> 
<set-dialog-area-position> 
< se t- dialog- are a- sur face> 
<set-dialog-ar ea-wr iting-mode> 
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If the values set by the most recent <set-alphatex t-si ze> , 
< set- dialog -are a- char s> , <set-dialog-area-lines> , and < set- 
dial og- area- posit ion> commands are such that the dialog 
viewport will not fit on the screen , then a type LV03 error 
occur s . If the current error threshold is 2 or less, a 
message is displayed to advise the operator that the set- 
tings have been changed . So long as the dialog area remains 
visible, the <repor t- terminal- setting s> command and the SET- 
UP mode STATUS command will report the altered settings . 
However, the old settings remain in the terminal's battery- 
powered backup memory . If the dialog area is made invisible 
again, then the <report- terminal- setting s> and STATUS 
command will report the settings stored in the backup 
memory . 

Whether the d ialog area is visible on power-up is determined 
by the current < en able- dialog- area> setting . ( Thi s setting 
is stored in the battery-powered backup memory . ) That way , 
on power-up the d ialog area is v isible if and only if it is 
enabled . 

Making the Dialog Area Invisible. If the < int> parameter is 
zero , the d ialog area becomes inv isible . 

NOTE 

Whether alphatex t is directed to the 
dialog area scroll does not depend on 
that scroll 1 s visibility. Even if the 
dialog area is visible , alphatex t may 
not be directed to it ; conversely , al- 
phatex t may be directed to the dialog 
area even tho ugh that area is invisible. 

It is the <enable-dialog-area> command 
which determines whether alphatex t is 
directed to the dialog area . See En- 
able- dialog- area> . 

The action of this command is identical to that caused by 
the DIALOG key from the keyboard ( light off = ; light on = 
1 ) . In itial value is . 
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Defaults 



Parameter 
Number 



As Shipped 
From Factory 



On Power-Up 



If the Parameter 
is Omitted 



1 







Same as the 
( rem embered ) 
setting for 



<enable-dialog 

-area) 



Errors 



LV03 (Level 0): One or more of the dialog area parameters 

was altered when the dialog area was made 
visible, 

LV11 (Level 2): Invalid dialog area visibility mode. (Must 

be or 1 ; in SETUP mode, must be YES or 
■NO..). 

Re f erences 

<Clear-dialog-scroll> command . 

DIALOG key. 

<Enable-dialog-area> command . 

<Se t-dialog-ar ea- buffer- si ze> command . 

<Se t- dialog- area- char s> command . 

<Se t-dialog-ar e a- index > command . 

<Set-dialog-ar ea-lines> command . 

<Se t-dialog-ar e a- po sition> command . 

<Se t-dialog-ar ea- sur f ace> command . 

<Se t-dialog-ar e a- wr iting-mode> command . 
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<Set-Dialog-Area-Wr i ting-Mod e> Command 



SETUP Mode Name: DAMODE 



SYNTAX 

<set-dialog-area-wr i ting-mod e> = (ESC) (L ) ( M) 

< in t : wr iting-mode> . 

PARAMETERS 

Writing-Mode (0 or 1). = REPLACE; 1 = VERSTRIKE . 



Description 

A value of 1 (overstr ike) indicates that d ialog area char ac- 
ter s are wr itten over old characters without first erasing 
the old characters . A value of (replace) indicates that 
d ialog area characters completely r epl ace the characters in 
that wr iting position . 

The terminal is shipped from the factory with the d ialog 
area wr iting mode set to zero ( repl ace) . In this mode , a 
character typed in the dialog area erases any characters 
formerly at that character position . This mode is useful 
with the "line ed iting" features of some host operating 
systems . 

A value of one ( overstr ike) lets you underl ine characters by 
backspac ing and typing over them with the "underscore" 
character , (_) . Thi s feature is useful with the APL 
character set , in which many "overstr ike" character combina- 
tions are used . 
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Def aul ts 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 Remembered 

Errors 



LM11 (Level 2): Invalid writing mode (must be or 1). 
References 

<Se t~d ialog-ar ea- index> command. 

<Se t- graph ics-area-wr i ting-mod e> command. 
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<Set-Duplex-Mode> Command Option 01 



SETUP Mode Name: DUPLEX 



SYNTAX 

<set~duplex-mode> = (ESC)(0)(D) 

<int : duplex-mode> . 

PARAMETERS 

Duplex-Mode (0 to 3)- = FULL; full duplex data 
communications protocol, 1 = NORMAL; half duplex nor- 
mal protocol, 2 = ARTS; half duplex with automatic 
request to send. 3 = SUPER; half duplex with supervi- 
sor . 



Description 

Normally, the terminal's duplex mode is set by the operator, 
using the "setup mode" DUPLEX command; see the appropriate 
operator's manual for details. However, the <set-duplex> 
"escape sequence" command is also provided for possible use 
by the host computer. 

The < set-duplex> command allows the host computer to set the 
duplex mode for the terminal 1 s communication with the host . 
An < in t> of zero pi aces the terminal in normal full duplex 
mode . Mode 1 is the normal half duplex mode . Mode 2 places 
the terminal in half duplex with an automatic request to 
send . Mode 3 puts the terminal in half duplex mode with a 
supervisor f unction operating from the host . 
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c 

Programming Considerations. This command (like all commands) 
does not take effect until the terminal has processed it . 
After the ho st send s this command , it should wait for the 
command to be completely processed through the terminal's 
input queue before sending additional data that relies on a 
mode set by the command . After send ing the < set-duplex> 
command , the host might issue a <report- terminal- sett ing s> 
command to inquire the terminal's duplex setting . The host 
would then read the < terminal- setting s- re port> which the 
terminal returns . If the terminal reports the correct duplex 
mode , then the host c an proceed with the rest of its 
program; otherwi se , it can issue another < report- term in al- 
settings> command and try again . 

Defaults 



Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 Remembered 

Errors 



OD00 (Level 2): Unrecognized command . (Option 1 is not 

installed . ) 

OD01 (Lev el 2): Inv al id duplex mode code ( must be in range 

to 3). 

References 
None , 
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<Set-Echo> Command 



SETUP Mode Name: ECHO 



SYNTAX 

<set-echo> = (ESC)(K)(E) 

< int : echo-mod e > . 

PARAMETERS 

Echo-Mode (0 or 1). = NO; no local echo. 1 = YES; 
local echo of transmitted data . 



Description 

If the < int> parameter is one, then characters which the 
operator types to the host are echoed locally by the 
terminal . 

If the < int> parameter is zero , all local echo ing is 
stopped . 

NOTE 

If the optional block mode communica- 
tions protocol is used , then local echo 
should be enabled • 
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Def aul ts 

Parameter As Shipped On Ppwfr-Up If the Parameter 

Number From Factory r is Omitted 

1 Remembered 

Errors 

KE11 (Level 2): Invalid echo mode (must be or 1 ) . 
References 

<Arm-for-block-mode> command . 
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<Set-Ed it-Char s> Command 



SETUP Mode Name: EDITCHARS 



SYNTAX 




<set-edit-chars> = (ESC) (K) (Z) 

\ ill u t Hal ■"Ucici/C/ 

<int: line- dele te> 
<int : take-literally> . 




PARAMETERS 




Char-Delete (0 to 127) . Numeric equivalent of 
SETUP mode char-delete character. 


the 


Line-Delete (0 to 127). Numeric equivalent of 
SETUP mode line-delete character. 


the 


Take-literally (0 to 127). Numeric equivalent 
SETUP mode take-literally character . 


of the 



Description 

The <set-edit-char s> command sets the values of the char- 
delete, line-delete , and take-literally characters which the 
operator can use for line editing whil e in SETUP mode . 

Specifying (NUL ) ( numeric equivalent zero) for any of these 
characters causes the present value of that character to be 
1 eft unchanged . 

Char-Delete Character . If , while in SETUP mode, the operator 
types a character incorrectly , he can press the the key for 
the current <char-delete> character . This deletes the char- 
acter just typed from the SETUP mode command line being 
typed . The cur so r backs up one character position , so that 
the operator can retype the character correctly . 
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( 

Line-Delete Character* If, while in SETUP mode , the operator 
types a command incorrectly, he or she can - before pressing 
RETURN - press the key for the current < 1 ine-delete> charac- 
ter . Thi s deletes the current SETUP mode command 1 ine . The 
cur so r advances to the start of the nex t 1 ine ; the terminal 
d ispl ays an asterisk to prompt the operator for another 
SETUP mode command 1 ine . 

Take-Literally Character . The take-literally character 
allows the operator to type (CR) ( or other special charac- 
ters) as part of a command . For instance , he may be typing a 
command which take s a del imited sequence of ASCII characters 
as a parameter , and want to include ( CR ) as part of that 
sequence . To do this , he types the current take-literally 
character , followed by (CR). 

The take-literally character causes the terminal to inter- 
pret the following character as just another data item . This 
lets the operator enter parameters which include (CR), the 
current char-delete character , the current 1 ine-delete char- 
acter , or even the current take-literally character . 



Defaults 



Parameter As Shipped 

Number From Factory 

1 127 - (DEL) 

2 24 - (CAN) 

3 126 - (~ ) 



On Power-Up If the Par ametei^ 

is Omitted 

Remembered Unchanged 

Remembered Unchanged 

Remembered Unchanged 
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Errors 



KZ 1 1 (Level 2): Invalid char-delete character ( must be in 

the range from to 127). 

KZ21 (Level 2 ) : Inv al id 1 ine-delete character ( must be in 

the range from to 127) . 

KZ31 (Level 2): Invalid take-literally character ( must be in 

the range from to 127) . 

References 

See the description of SETUP mode in the Operator 1 s Manual 
for the particular TEKTRONIX 4110 Series Computer Display 
Terminal . 
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<Set^EOF-String> Command 
SETUP Mode Name: EOF STRING 



SYNTAX ■ ■: 

<set-EOF-string> = (ESC) (N) (E) 

< in t- array: end- of- f lie- str ing > 

PARAMETERS 

End-Of-File-Str ing . This <int-array> holds numeric 
equivalents of up to ten ASCII characters, which 
comprise the <EOF-str ing> . Each numeric equivalent 
must be in the range from to 1 27 . 



Description 

This command sets the terminal's <EOF-str ing> (end-of-f ile 
str ing) . 

The <EOF~str ing> is used ( when the terminal is not in block 
mode) to mark the end of a file being transferred between 
the terminal and the host computer . ( In block mode , a bit in 
one of the control bytes at the end of the block serves a 
similar purpose . ) 



If the terminal is not in block mode , it appends the current 
<EOF-str ing> to the end of each file it sends to the host in 
response to a <copy> command . When the host is send ing a 
file to the terminal , it should append the current <EOF- 
str ing> at the end of its transmission . (This lets the 
terminal know when the end of the file has been reached . ) 

When the terminal is in block mode , the end-of-f ile bit in 
the < block-con trol- by tes> takes the place of the <EOF- 
str ing> . When the terminal is in block mode , or is armed for 
block mode , it is incapable of recognizing the <EOF-str ing> 
in data coming from the host computer . 
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NOTE 

If you will not be using block mode, do 
not arm the terminal for block mode. If 
the terminal is armed for block mode, 
but is not yet actually in block mode, 
the only way to terminate a <copy> from 
the host is with the CANCEL key. 



The terminal intercepts <EOF-str ing> s in data coming from 
the host, and deletes them from the incoming data stream. 
Because of this, it may be prudent to set the <EOF-str ing> 
to the desired value only just before each <copy> operation, 
and to set the <EOF-str ing> to the empty string after the 

< copy> . 

Besides the command, the following commands also use s when 
sending data to, or receiving data from, the host computer: 
<dir ec tory> , < load> , <plot>, <port-copy>, < save) , and 

< spool> . 



Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 Empty array Remembered Empty array 



Errors 



NE11 (Level 2): Invalid EOF-str ing (must contain from to 

10 characters, with each character repre- 
sented by an <int> in the range from to 
127). 

NE12 (Level 3 ) : Parameter 1 memory error. (Out of memory 

while parsing the < int-arr ay> parameter.) 
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Re f erences 

<Arm- for-block-mode> command . 

<Copy> command . 

<Direc tor y> command . 

<Load> command . 

<Plot> command . 

<Port-copy> command . 

<Save> command . 

<Spool> command 9 
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<Se t-EOL-Str ing> Command 
SETUP Mode Name: EOLSTRING 
SYNTAX 

<set-E-OL-string> = (ESC)(N)(T) 

< in t-arr ay : EOL-str ing> . 

PARAMETERS 

EOL-String . An array of from to 2 <int>s . Each <int> 
is the numeric equivalent of an ASCII character , and 
so must be in the range from to 1 27 • 



Description 

This command sets the <EOL-str ing> (end-of-line string) . 
This str ing is typically the single character , ( CR) ; the 
< set-EOL-str ing> command lets you set it to other combina- 
tions , such as , say , ( CR ) (LF) . 

In block mode , the terminal send s the <EOL-str ing> at the 
end of each 1 ine it send s to the host. 

When not in block mode , the <EOL-str ing> is inserted within 
11 reports" which the terminal send s the host ; see the syntax 
description for the par ticul ar report type for detail s . 



Defaults 



Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 1 3 - ( CR) Remembered Empty array 
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Errors 



NT 1 1 (Level 2): Invalid array count in < int-arr ay> . (The 

array must hold from to 2 <int> parame- 
ters. Each <int> in the array must be in the 
range from to 127. ) 

NT 12 (Level 3 ) : Parameter 1 memory error. (Out of memory 

while parsing the < int-arr ay> parameter.) 

Re f erences 

<GIN-locator-repor t> syntactic construct. 
<GIN-pick-report> syntactic construct. 
<GIN-report- sequence> syntactic construct. 
<GIN-stroke-report> syntactic construct. 
<Report-dev ice- status > command . 
<Report-errors> command . 
<Report-por t-status> command . 
< Re po r t- segment- stat us > command . 
<Report- terminal- setting s> command . 
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<Set-EOM-Chars> Command 



SETUP Mode Name: EDM CHARS 



SYNTAX 

<set-EOM-chars> = (ESC) (N) (C) 

< int : an-EOM-char> 

< int : an o the r -EOM- char > . 

PARAMETERS 

An-EOM-Char (0 to 127) . Numeric equivalent of an <E0M- 
char> : an ASCII character marks the end of a 1 ine of 
text in data sent to the host computer . Zero means "no 
character . " 

Another-EOM-Char (0 to 127) • Numeric equivalent of 
another <E0M-char> . (If only one <E0M-char> is 
desired , set one of the two parameters in the <set- 
E0M-chars> command to zero* If no <E0M-chars> are 
desired , set both parameters to zero .) 



Description 

Specifies one or two characters to be used as " turnaround" , 
or EOM ( end of message) characters . 

The ASCII (NUL ) character ( whose numeric equivalent is zero) 
may not be used as an EOM character . You can specify any 
other ASCII character as an EOM character by includ ing its 
numeric equivalent as one of the two < int> parameters in 
this command . To specify only one EOM character , give its 
numeric equivalent in one of the <int>s , and set the other 
<int> to zero . To designate no EOM characters , set both 
<int> parameters to zero . 



4110 SERIES COMMAND REFERENCE REV.DEC1981 



4-393 



ALPHABETICAL LISTING 



Use of EOM characters . 

When send ing text to the ho st computer , the terminal must 
know when each 11 line" of text ends. (This is necessary for 
the d if ferent communications protocols to work properly . For 
instance , in half dupl ex normal mode , the terminal must 
pause at the end of each 1 ine in order that the host may 
have a chance to seize control of the communications 1 ine . 
Li kewi se , in prompt mode the terminal must pause at the end 
of each 1 ine and wait for a prompt from the ho st before 
send ing the next 1 ine . ) 

There are two ways the terminal can tell when it has reached 
the end of a 1 ine of text in the data it sends to the host . 
One of these ways is by recognizing an <EOM-char> in the 
d ata being transmitted. Typically, the <EOM-char> would be 
( CR) . Thus , whenever the operator presses the RETURN key to 
send a ( CR) to the host , the terminal send s the ( CR) as the 
1 ast character on the current line of tex t . It then waits 
for the current transmit delay before sending the f ir st 
character of the next 1 ine of text. 

(The other way the terminal recognize s the end of a line of 
text is by encountering an <EOM-ind icator> in the text being 
transmitted . <EOM-ind icator> s occur in reports which the 
terminal sends to the host . When the terminal is not in 
block mode and encounters an <EOM-ind icator> , it sends the 
current <EOF-str ing> and then pauses before send ing the 
f ir st character of the next 1 ine . For more information , see 
<EOM-indicator> . ) 

When the terminal is not in block mode , and it encounters an 
<EOM-char> in the data it is sending, it transmits the <EOM- 
char> and then pauses for a length of time determined by the 
most recent < set- transmit- del a y> command . ( In block mode , 
the terminal packs the into the block , terminates the block , 
and sets the end-of-message bit in the <block-control- 
bytes> . ) 

Prompt Mode . In prompt mode, the terminal sends the <EOM- 
char> and then waits until ( a) the transmit del ay has 
expired , and ( b) it has r eceiv ed a prompt from the host . 
Only after both these cond itions are met can the terminal 
send the f ir st character of the nex t 1 ine of text . 
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Half Duplex Modes. When using half duplex data communica- 
tions , the terminal send s the <eom-char> and then rel eases 
the use of the communications line for a period of time 
determined by the most recent < set- tr ansm it-delay> commando 
This gives the host computer a chance to seize the line and 
transmit data to the terminal. After the transmit delay, if 
the terminal has more data to send, then it seizes the line 
again and sends that data, (In "half duplex with automatic 
request to send" mode, the terminal seizes the line again 
regardless of whether it has data to send . ) 

Block Mode. In block mode , when the terminal encounters an 
<EOM-char> (or <EOM-indicator> ) in the data it is packing 
into a block , it terminates the block , sets the end-of- 
message b it in the <block-control-bytes> , and sends the 
block to the host computer . 



Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 13 - (CR) Remembered - (NUL) 

2 - (NUL) Remembered - (NUL) 
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Errors 



NC11 (Level 2): Invalid value in parameter T. (Must be in 

the range from to 127*) 

NC21 (Level 2): Invalid value in parameter 2 . (Must be in 

the range from to 127.) 
No errors are detected for this command . 



Re f erences 

<Se t- block- packing > command . 
<Duplex> command. 
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<Set-Er ror-Threshold> Command 



SETUP Mode Name: ERRORLEVEL 



SYNTAX 

<set-er"ror-threshold> = (ESC)(K)(T) 

<int : error- thr eshold-level> . 

PARAMETERS 

Error-Threshold-Level (0 to 4). The minimum error 
severity for an error message to be displayed, "Zero" 
causes all errors to be displayed, while "four" 
suppresses all error messages. 



Description 

Sets the minimum severity level for errors whose messages 
are to be displayed. 

Errors are always recorded in the terminal's error queue , 
and the report may be obtained with the <report-error s> 
command . 



Def aul ts 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

12 2 
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Errors 



KT11 (Level 2): Invalid error threshold ( must be in range 

from to 4 ) . 

References 

<Repor t-error s> command . 
Appendix C, "Error Codes." 
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<Set-Fixup-Level> Command 4112, 4113 



SETUP Mode Name: FIXUP 


SYNTAX 




<set- f ixup-level> = 


(ESC) (R)(F) 

< int : f ixup-level> . 


PARAMETERS 




Fixup-Level (0 to 6) 

quentl y the terminal 
its display. 


. A number specifying how f re- 
updates the current viewport in 



Description 

The command is available only in the 4112 and 4113 termi- 
nals . 

This command controls the amount of time spent upd ating the 
current v iewpor t on the terminal when changes are made that 
affect the current view. Although this could be done with 
every change , this might be a time-consuming task for 
complex views . The higher the f ixup level , the more effort 
will be spent upd ating the viewport . A complete upd ate 
occur s on a <renew-view> command , a <page> command , or a 
depression of the PAGE key . 

Table 4-1 8 lists the f ixup levels and their meanings . A 
f ixup level not 1 isted in the table has the same effect as 
the next lower f ixup level which i_s 1 isted . For instance , 
f ixup level 3 has the same effect as f ixup level 2; f ixup 
level 1 00 has the same effect as f ixup level 6 . 

The defaul t f ixup level is six . 
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Table 4-18 
FIXUP LEVELS 



Fixup 
Level 


Meaning 





The screen is updated on a <renew-view> or <page> command , 
or when the PAGE or VIEW key is pressed, 

(At fixup level 0, these are the only times the viewport 
contents are altered,) 


2 


The action listed above for fixup level is performed* 
Besides this ? the display is updated to show any additions 
to the current view, as tho se additions are made, (For 
instance , whenever a line is drawn in the current v iew , 
the display is updated to show that line. Again , whenever 
a segment is made visible, the display is updated to show 
that segment . ) 

(At fixup level 2, when a segment is moved, it is drawn in 
the new position, but not erased from its old position. 
The display is not updated when a segment is made invisi- 
ble , or deleted . ) 


4 


The actions listed above for fixup levels and two are 
performed, In addition, segments displ ayed in XOR mode are 
erased (by drawing them again in XOR mode) in response to 
commands that change the segment T s v i sib 1 it y or po si t ion 

in terminal space. 

Segments displayed in SET mode are treated as in fixup 
level two . 


6 


The actions described aboved for fixup levels through 4 

are performed. In addition, whenever a segment is made 
invisible or is deleted, that segment is erased from the 
viewport. (For segments drawn in SET mode , this is done by 
redrawing the segment in the current wipe index . For 
segments drawn in XOR mode , this is done by redrawing the 
segment in XOR mode . ) 


4-400 


rev, dec 1981 4110 SERIES COMMAND REFERENCE 



ALPHABETICAL LISTING 



Def aul ts 



Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 6 6 



Errors 



RFOO (Level 0): Unrecognized command. (The terminal is not a 

41 12 or a 41 13.) 

RF11 (Level 2): Invalid fixup level (must be in the range 

to 6) . 

References 



<Se t- segment-wr i ting -mod e> command . 
<Se t- segment-visibil ity> command . 
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<Set«-Flagging-»Mode> Command 
SETUP Mode Name: FLAGGING 



SYNTAX 

<set-flagging-mode> = (ESC) (N) (F) 

< in t : f 1 agging-mode> . 

PARAMETERS 

Flagging-Mode (0 to 4) . .0 = NONE; no flagging. 1 = 
INPUT ; DC 1. /DC 3 flagging when receiving data from the 
host. 2 = OUTPUT; DC1/DC3 flagging when transmitting 
to the host. 3 = IN/OUT; DC1/DC3 flagging both when 
tr ansmitting and when receiving . 4 = DTR/CTS ; flagging 
with the Data Terminal Ready and Clear To Send RS-232 
signal 1 ines . 



Description 

This command sets the " flagging or "handshaking protocol 
between the terminal and its host computer . (The < set-port- 
f lagging-mode> command controls similar protocols between 
the terminal and its RS-232 peripheral dev ices . ) 

Mode (No Flagging) . DC1/DC3 and DTR/CTS flagging are both 
d isabled . 



NOTE 

When DC1/DC3 flagging is enabled , block 
mode protocol is being used , and the 
number of packed data bits per pseudo 
byte is 7 or 8, the DC 1 (ADE17) and DC 3 
( ADE19) must be includ ed in the block 
mode fl non-tr ansmittable" characters 
list . 
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Mode 1 (INPUT ) • The terminal uses the "DC1/DC3" flagging 
protocol when receiving characters from the host* If the 
host is send ing characters to the terminal faster than the 
terminal can process them , so that the terminal T s input 
buffer is in danger of overflowing , then the terminal sends 
the host a (DC3) character . The host is then expected to 
suspend transmission of characters to the terminal . When the 
terminal is ready for more characters, it send s the host a 
(DC 1 ) . The ho st is then expected to resume transmission of 
characters to the terminal . 

Mode 2 (OUTPUT)- The terminal uses the "DC 1 /DC 3" flagging 
protocol when transmitting characters to the host . The host 
c an send the terminal a (DC3) when its input buffer is in 
d anger of overflowing . The terminal sends at most 1 or 2 
more characters , and then stops transmitting to the host . 
When it receives a ( DC 1 ) , the terminal resumes its transmis- 
sion to the host . 

Mode 3 (IN/OUT) . The terminal uses the "DC1/DC3" flagging 
protocol both when receiv ing characters from the host and 
when transmitting characters to the host . 

Mode 4 (DTR/CTS) . In DTR/CTS flagging , two signal lines at 
the RS-232 connector are used to regul ate the flow of data 
between the terminal and the host computer . These 1 ines are 
DTR (Data Terminal Ready) and CTS (Clear To Send), 

NOTE 

DTR/CTS flagging is usually not practi- 
cal when the host is connected to the 
terminal over telephone lines by the use 
of modems . (In such a circumstance , the 
host does not have direct access to the 
DTR and CTS signal lines.) This fl agging 
mode is only practical if the host is 
connected directly to the terminal . 
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The terminal indicates that it wishes to transmit data by 
asserting RTS (placing a positive voltage on the RTS signal 
line) . If the host is ready to receive the data, it asserts 
CTS. The terminal is only allowed to transmit when CTS is 
asserted. Should the terminal be transmitting characters 
faster than the host can. process them, so that the host's 
input buffer is in danger of overflowing , -the host can drop 
CTS (place a negative voltage on the CTS signal line). With 
CTS negative, the terminal automatically stops transmitting. 
When the host is ready to receive more characters, it 
asserts CTS again , and the terminal resumes its transmis- 
sion . 

If DTR/CTS fl agging is enabled , the terminal uses the DTR 
(Data Terminal Ready) signal 1 ine in the same way that the 
host uses the CTS 1 ine . If the host is sending characters 
faster than the terminal can process them , so that the 
terminal's input buffer is in danger of overflowing, then 
the terminal drops DTR ( places a negative voltage on the DTR 
signal line) . The host is then expected to stop transmitting 
to the terminal . When the terminal is read y for more 
characters , it asserts DTR ( places a positive voltage on the 
DTR line) , and the host resumes its transmission to the 
terminal . 



Def aul ts 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 Remembered 

Errors 



NF1 1 (Level 2): Invalid fl agging mode ( must be in the range 

from to 4) . 

References 

<Se t- bloc k-non-xmt- char s> command 
<Se t- port- f 1 agging-mode> command . 



4-^04 



REV, DEC 1981 4110 SERIES COMMAND REFERENCE 



ALPHABETICAL LISTING 



<Set-GIN-Cursor> Command 



SYNTAX 




<set-GIN-cursor> = (ESC)(I)(C) 

< in t : device- 


f unc tion-code> 


<int : segment 


-number> . 


PARAMETERS 




Device-Function-Code . A graphic 
code • ( See <enable-GIN> command 


input device-function 
for details. ) 


Segment-Number (0 to 32767) • The 

which is to be used as a graphic 
zero" is the crosshair cur sor . 


number of the segment 
cur sor . "Segment 



Description 

This command specifies which segment is to be used as the 
graphics cur sor for all sub sequent GIN operations , using the 
specified graphic input device- function combination . No 
action is seen when this command is given ; the resul t will 
be seen 1 ater , when an <enable-GIN> command is issued for 
the specified dev ice- f unction combination . 

When a segment is enabled as the GIN cur sor , it is the 
segment ! s pivot po int which r epl aces the intersection of the 
crosshair s in the defaul t crosshair cur sor . 

As far as selecting the GIN cur sor is concerned , the 
<enable-401 0-GIN> command is considered to be the same as an 
<enable-GIN> command for dev ice-f unc tion code zero 
( thumbwheel s device , locator function) . That is , a <set-GIN- 
cursor) command for device- function zero selects a cur sor 
not only for use with <enable-GIN> commands with dev ice- 
function code zero , but al so for use with <enable-401 0-GIN> 
commands . 
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When the named dev ice- function is later enabled , the segment 
attributes of this segment are changed as follows: 

Display mode is set to refresh mode on a 4114, or to 
XOR mode on a 4112 or 4113. 

De tectab il ity is turned off . 

Visibility is turned on. (If the sampled device is the 
tablet, the segment is visible when the pen is in 
presence; when out of presence its visibility depends 
on the segment's original visibility attribute,) 

As the sampled device is manipul ated , the cursor segment's 
position is continuously updated . When a GIN event occur s , 
the cursor position is sent to the host as part of the GIN 
report for that event . 

When the device is disabled, the display mode, detec tab il i- 
ty , and v isib il ity attr ibutes are restored to their original 

values. The segment's position attribute, however, is not 
restored . 

Default, If no < set-GIN-cur sor> command has been issued, 
then " segment 0" -- the standard crosshair cur so r serves 
as the graphics cur sor . 

By use of the < set-GIN-cur sor> command , however, another 
segment may be used as a graphics cursor. 

If setup mode is entered while GIN is enabled, the graphic 
cursor will disappear until setup mode is ex ited . While in 
setup mode , the enabled dev ice ( thumbwheels , tablet , . . • ) 
will NOT be used for input to the suspended GIN operation . 

Several dev ice/ functions can specify the same cursor al- 
though the cursor movement may be undefined if an attempt is 
made to use more than one such dev ice/ function at a time . 

If the specified segment does not ex ist , or if thi s command 
is issued whil e the spec if ied function is enabled , an error 
occur s . 



4-^406 



rev, dec 1981 4110 SERIES COMMAND REFERENCE 



ALPHABETICAL LISTING 



In the 4112 or 4113, the cursor is scaled according to the 
current view transform and image transform . The cur sor 
cannot be moved outside of the current v iewport . If a 
another view is selected as the current view, the c ur so r 
moves to that view's v iewport and is scaled to r ef 1 ect the 
new view 1 s window-viewport transform . However , the def aul t 
crosshair cur sor , unl ike other segments , is not cl ipped at 
the v iewport boundary . 

If the cur sor is the default cursor ( segment zero , the 
crosshair cur sor ) , its po sition may be set with the < se t- 
segment-position> command . In the 4112 and 4113, however , 
the default cur sor cannot be positioned out sid e the window 
for the current view. The terminal will position it as close 
to the specified po int as possible , constraining it to be 
within the current window. An y graphic input dev ice motion 
will restore the defaul t cur sor to its position prior to the 
< set- segment- posit ion > command . 

If a cur sor other than the defaul t cur sor is used , its 
position may be set using either the < set- segment- po si tion> 
command or the < set- segment- image-tr ansform> command . In the 
4112 and 4113, if the non-def al t cur sor is set outside the 
current window , it ceases to be v isible in the current 
v iewport . However , any graphic input dev ice motion will 
restore the cur sor back to its position prior to the < set- 
segment- po i sit ion> or < set- segment- image- 1 ran sform> command . 
It will then move from that po int in response to the graphic 
input dev ice . This dev ice may not , by itself, move the 
cur sor outsid e the window . 



Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 None None Error IC20 

2 Error IC20 
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Errors 



IC 1 3 (Level 2): Graphic input has already been enabled for 

the specified dev ice- f unction code. 

IC20 (Level 2): Segment does not exist, or is currently 

being defined . 

IC21 (Level 2): Invalid segment number (must be in the range 

to 32767) . 

References 

<Enable-GIN> command . 

<Se t- pivot- po in t> command. 
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<Set-GIN-Gr idding> Command 



SETUP Mode Name: GRIDDING 



SYNTAX 




<set-GIN-gridding> = 


(ESC)(I)(G) 

< int : dev ice- f unction-code> 

< int : grid- spac ing > 

< int : y-grid-spac ing> . 


PARAMETERS 




Device-Function-Code. A graphic input device- function 
code. (See <enable-GIN> command for details.) 


X -Grid-Spacing (0 to 

grid spacing. 


4095 ) • Horizontal ( x-dir ection) 


Y-Gr id-Spacing (0 to 

grid spac ing . 


4095) . Vertical ( y-direction) 



Description 

Causes appl ication of gridding to all subsequent operations 
of the specified locator or pick functions . The x ,y parame- 
ters specify an invisible grid that covers the entire screen 
space on a 4114 or terminal space on a 4112. All further 
graphic cur so r movement is constr ained so that the cur so r 
will always 1 ie on po ints correspond ing to the intersections 
of these grid 1 ines . 

An x-spacing ( or y-spacing) of zero disables gridding in the 
x-direction ( y-direction) . Specif ying zero for both these 
parameters turns off the gridding feature . 
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( 



Valid grid spacings range from to 4095 . Note that a grid 
spacing of one serves no useful purpose, since points cannot 
be closer together than one terminal space unit . (It would 
be better to specify a spacing of zero , and thus save some 
time by disabling gr idding . ) Note al so that large grid 
spac ings are impractical , (X- and y-spacings of 4095 would 
permit only four accessible po ints , at the four corners of 
terminal space . ) 

Gr idd ing appl ies only to the locator and pick functions ; 
gr idding is not permitted for the stroke function . 

Def aul t is no gr idding ( x- and y-spac ing both zero) . 

For purposes of gridding , an <enable-401 0-GIN> command is 
considered to be an <enable-GIN> command for dev ice- function 
code zero. That is, a <set-GIN-gr.idding>. command for dev ice- 
function zero ( thumbwheel s dev ice , locator function) affects 
graphic input in response to an < enable-401 0-GIN> command as 
well as graphic input in response to an <enable-GIN> command 
for dev ice-function zero . 



Def aul ts 



Parameter 
Number 



As Shipped 
From Factory 



On Power- Up 



If the Parameter 
is Omitted 



None 



None 







2 















3 
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Errors 



1 002 (Level 2): Insufficient memory available for GIN 

functions . 

1011 (Level 2): Invalid dev ice- function code. (See the de- 
scription of the <enable-GIN> command for a 
table of device- function codes.) 

IG10 (Level 2): Gridding does not apply to the specified 

device- function code. (Gridding is not al- 
lowed for the stroke function . ) 

IG21 (Level 2): Invalid x-spacing (must be in the range from 

to 4095) . 

IG3 1 (Level 2): Invalid y-spacing (must be in the range from 

to 4095) . 



References 

<Enable-4010-GIN> command. 
<Enable-GIN> command . 



4110 SERIES COMMAND REFERENCE REV.DEC1981 



4-411 



ALPHABETICAL LISTING 



<Set-GIN~Inking> Command 



SYNTAX 

<set-GIN-inking> = (ESC) (I) (I) 

< int : device- f unction-code > 

< in t : in-king-mod e > . 

PARAMETERS 

Device-Function-Code. A graphic input device-function 
code* (See <enable-GIN> command for details,) 

In king-Mode (0 or 1 ) . One enables inking for the 
specified device- function code. Zero disables inking. 



Description 

Turns inking on or off for all subsequent operation of the 
specified locator or stroke function. 

Device-Function Code, The dev ice- function code parameter is 
an <int> specifying the GIN device (thumbwheel, tablet, or 
plotter ) and GIN function ( locator or stroke) . ( Inking is 
not allowed for the pick function . ) See the description of 
the <enable-GIN> command for detail s . 

Inking Mode. The inking mode parameter is zero to turn 
inking off, or one to turn inking on . With inking turned on , 
each locator event after the first causes a 1 ine to be drawn 
to the po int sel ec ted by the locator event . Dur ing stroke 
functions , a 1 ine is drawn between each po int in the stroke . 

On a 4114, the line is drawn in storage mode, using the 
current 1 ine style and line width , as set by the most recent 

< set- line- st yl e> and < set-line-width> commands . On a 4112 or 
4113, the 1 ine is drawn using the current 1 ine style and 

1 ine index , as set by the most recent < set-line-style> and 

< set-line- index> commands . 

If the second < int> = , inking is deactivated . The terminal 
is initial ized with inking turned off. 
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Defaults 



Parameter 
Number 



As Shipped 

From Factory 



On Power- Up 



If the Parameter 
is Omitted 



None 



None 







2 















Errors 



1011 (Level 2): Invalid dev ice- function code . (See the de- 
scription of the <enable-GIN> command for a 
table of device- function codes.) 

II 10 (Level 2): Inking does not apply to the specified 

dev ice- function code, (Inking is not allowed 
for the pick function.) 

1 1 21 (Level 2): Invalid inking mode (must be or 1). 



References 

<Enable-GIN> command . 
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<Set-GIN-Rubberbanding> Command 



SYNTAX 

<set-GIN~rubberbanding> = (ESC) (I)(R) 

< in t : device- f uric tion-code > 

< irit : rubber band ing-mode> . 

PARAMETERS 

Device-Function-Code • A graphic input device-function 

code. (See <enable-GIN> command for details . ) 

Hubberbanding-Mode (0 or 1 ) . Zero turns rubberbanding 

off. One turns rubberband ing on. 



Description 

Turns r ubberband ing on or off for all subsequent operations 
of the specified locator f unction . 

Dev ice- function code . The dev ice- function code is an < int> 
specifying the GIN device ( thumbwheel s , tablet , or plotter ) 
and the GIN function . (See the <enable-GIN> command for 
detail s . ) The GIN function must be the locator function ; 
r ubberband ing is not allowed for the pick and stroke 
functions . 

Rubberbanding mode • The r ubberband ing mode parameter is 
another <int> parameter : zero to turn rubberband ing off , or 
one to turn rubberband ing on . 

With rubberbanding turned on and the specified dev ice- 
function enabled , a 1 ine is drawn from the most recently 
selected po int to the current cur so r position . On a 4112, 
the 1 ine is drawn in XOR mode , using the current 1 ine style 
and line index . On a 4114, the 1 ine is drawn in refresh 
mode , using the current 1 ine style and 1 ine width . If dashed 
lines are used , the pattern of dashes begins at the fixed 
end of the 1 ine . 
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If rubberband ing is turned on or off while the GIN device is 
enabled , only sub sequent po ints are affected . 

The beam position is not affected by the rubberband ing mode . 



De f aul ts 



Parameter 
Number 

1 

2 

Errors 



As Shipped 
From Factory 

None 





On Power-Up 

None 




If the Parameter 

is Omitted 






101 1 (Level 2) 



IR10 (Level 2) 



IR21 (Level 2) 
References 



Invalid device- function code • (See the <en- 
able-GIN> command for a table of device- 
function codes . ) 

Rubberband ing does not apply to the speci- 
fied dev ice- function code . (Rubberband ing is 
only allowed for the locator function . It is 
forbidden for the pick and stroke func- 
tions • ) 

Invalid rubberband ing mode ( must be or 1 ) . 



<Enable-GIN> command 



4110 SERIES COMMAND REFERENCE REV,DEC1981 



4-415 



ALPHABETICAL LISTING 



<Set-GIN-Stroke-Filteririg> Command 



SYNTAX 

<Set~gin-stroke-filtering> = (ESC)(I)(F) 

< in t : device- fun ction- 

code> — - 

<int : d i stance- filter > 
<int : time-f ilter> . 

PARAMETERS 

Device-Function-Code. A graphic input dev ice- function 
code. (See <enable-GIN> command for details,) 

Distance-Filter (0 to 4095). Minimum change in x- 

coordinate or y^coordinate in order for the terminal 
to send another <GIN-stroke-r epor t> to the host compu- 
ter . A value of zero disables the distance filter. 

Time-Filter (0 to 32767) V Minimum time in milliseconds 
between stroke events . A value of zero disables the 
time filter . 



Description 

The specified stroke filtering parameters are appl ied to all 
subsequent operations of the specified stroke function . 

Device-Function Code. The dev ice-function code is an <int> 
parameter specifying the GIN dev ice (which must be the 
tablet) and the GIN function ( which must be stroke func- 
tion) . See the description of the <enable-GIN> command for 
details . 

Distance-Filter . The distance- filter parameter specifies the 
minim urn distance the tablet pen or cur so r must move in 
either x- or y-direction before a new po int is output . This 
d istance is expressed in terminal space coordinates ; if 
either coordinate changes by more than this distance , then 
the terminal will send a new <GIN-stroke-report> to the 
host . 
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Time-Filter. The time- filter parameter specifies the minimum 
time in milliseconds that will elapse between successive 
points. As the operator moves the tablet pen or four-button 
cursor, <GIN-stroke-repor t> s are sent to the host only at 
intervals of "time" milliseconds. 

(The terminal measures time in increments of about 25 
milliseconds . Thus , specifying a time of 1 ms is , for 
pr atical purposes , the same as specifying a time of zero. 
Again , for pr atical purposes , 27 ms is the same as 25 ms.) 

If both the "distance- filter" and " time- filter" parameters 
are non-zero , then all criteria of both parameters must be 
met for an stroke report to be sent to the host . 

When stroke filtering is first enabled ( or when the tablet 
stylus or cur so r is 1 ifted away from the tablet) , the 
filters are reset so that at the first pen contact , a po int 
is returned . 

Note that if either the distance or the time parameter is 
zero , then that type of filtering is absent . With no 
filtering , po ints are output at the maximum speed of the 
tablet interface . 

Filtering does not affect the cur so r movement , but does 
affect the image formed by inking : inking occur s only 
between those points whose coord inates are reported to the 
host . 

Locator and pick functions are not affected . Def aul t is no 
filtering . 



Def aul ts 



Parameter 
Number 

1 

2 
3 



As Shipped 
From Factory 

None 







On Power-Up 

None 







If the Parameter 
is Omitted 

Error IF10 
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Errors 
<ERRIF.p4» 

Re f erences 

<Enable-GIN> command. 

<GIN-stroke-report> syntactic construct. 



4-418 



REV, DEC 1981 4110 SERIES COMMAND REFERENCE 



ALPHABETICAL LISTING 



<Set-Graphics-Area-Wr iting-Mode> Command 4112, 4113 



SETUP Mode Name: GAMODE 



SYNTAX 






<set-gr aphic s-area-wr iting 


-mode> 




= (ESC) (M) (G) 

< int : wr iting-mode> 






PARAMETERS 






Writing-Mode (0 or 1 ) . = 


REPLACE; 1 : 


= OVERSTRIKE. 



Description 

The exists only in the 4112 and 4113 terminals. 

This command sets the wr iting mode for alphatex t which is 
not d ispl ayed in the dialog area . (The <set-dialog-ar ea- 
wr iting-mode> determines the wr iting mode for d ialog area 
tex t . ) 

A v alue of 1 (overstr ike) indicates that characters are 
wr itten over old characters without first erasing the old 
characters , A v alue of (repl ace) indicates that new 
characters completely replace the old characters in that 
wr iting po sition . 

The 4112 or 4113 is shipped from the factory with the 
graphics area wr iting mode set to 1 (overstrike) . With the 
wr iting mode set this way , the operator or the host can 
underl ine characters by backspac ing and typing over them 
with the "underscore" character , (__) . This feature is useful 
with the APL character set (Option 4E ) , in which many 
"overstr ike" character combinations are used . 
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A value of ( repl ace) causes a character typed in the 
d ialog area to erase any characters formerly at that charac- 
ter position . Thi s means that underl ining is not possible . 
Ho wever , this mode of wr iting is useful with the "line 
ed iting" features of some ho st operating systems . 

Interaction With <Set-Background-Indices> Command . In the 

4113, the < set-graphics-area-wr iting- mod e> and <set- 
bac kg round- ind ices> commands both affect how alphatex t is 
d ispl ayed outside the graphic area . Thus , either of these 
commands can supersede the effect of the other . 

Thus , i f you change a 4 1 1 3 1 s graphic area wr iting mode to 
OVERSTRIKE, the text-background-index of the <set-back- 
ground- ind ices> command is set to - 1 . If you change the 
graphic area wr iting mode to REPLACE, then the tex t-back- 
ground-index is set to -2. 

Likewise, a < set-background- index> command which changes the 
tex t- background- index to - 1 al so changes the graphic area 
wr iting mode to OVERSTRIKE . Again , changing the text-back- 
ground-index to -2 also changes the graphic area wr iting 

mode to REPLACE. 



Defaul ts 

Parameter As Shipped On Power- Up If the Parameter 

Number From Factory is Omitted 

1 1 Remembered 

Errors 



MGOO (Level 2 ) : Unrecognized command . (Terminal is not a 

4112 or a 4113.) 

MG1 1 (Level 2) : Invalid parameter . (Must be or 1 ; in SETUP 

mode, must be OVERSTRIKE or REPLACE.) 

Re ferences 
command . 

<Se t- dialog- area- wr iting-mode> command . 
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<Se t-Gr aphtex t-Font> Command 



Syntax 



<set-graphtext-font> = (ESC) ( M) ( FX int> 
font number 



Description 

This command determines which character font will be used to 
d ispl ay subsequent " stroke precision" graphtex t . Gr aphtex t 
is text occurring within a <graphic- text> command ; it can be 
used within graphic displays and picture segments , and 
( unl ike alphatex t) can be rotated . 

The defaul t graphtex t font is font zero , the standard ASCII 
font . If an optinal keyboard is installed , then four other 
predefined graphtex t fonts are available; Table 4-1 9 lists 
them . 

If the terminal has an optional keyboard (Swedish , U.K., 
APL , or Danish/Norwegian) , then graphtext fonts 1, 3, 7, and 
9 , in addition to font 0, are predefined . If the terminal 
does not have an optional keyboard , then only font is 
predefined . 

The user can define other graphtext fonts , numbered from 
to 32767 . (To do this , use the following commands : <set- 
graphtex t-font-gr id> , <begin-gr aphtex t- char act er> , and <end- 
graphtex t- char act er> . ) 
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Table 4-19 

GRAPHTEXT FONTS AVAILABLE WITH KEYBOARD OPTIONS 



Font Number 


Graph text Font 





Standard ASCII 


1 


Swedish 


3 


United Kingdom 


7 


A PL 


9 


Danish/Norwegian 



User-defined graphtex t characters supercede predefined ones . 
Thus , you can re-define some or all of the characters of 
font 0. (If you 1 ater delete these user- defined characters , 
they are superceded by the corresponding predefined charac- 
ters. ) 

If you select a font which has no user-defined characters , 
then the predefined font with the same font number is used . 
If there is no pre-defined font with that number , then font 

zero ( the ASCII font) is used. 

Li kewi se , any undefined characters in a user-defined font 
default to the correspond ing characters of the predefined 
font with the same font number.. If. there is no predefined 
font with that number, the corresponding characters of font 
zero are used . 
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Def aul ts 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 See table in text. See table in text. 

Errors 



MF10 (Level 2): Font does not exist. 

MF11 (Level 2): Invalid font number (must be in the range 

from to 32767 ) . 

References 

<Begin-gr aphtext- char act er> 
<En d- gr aphtext- char acter> 
<Gr aphtex t-char- def in it ion> 

<Save> 
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<Set-Graphtext-Font-Gr id> Command 



SYNTAX 




<set~graphtex t- font-gr id > 


= (ESC)(S)(G) 

<int : font-number> 
<int : gr id-width> 
< in t : gr id-he ight> . 


PARAMETERS 




Font-Number (0 to 32767). 
which a font grid is being 


Names the graphtex t font for 
defined . 


Grid-Width (1 to 4095). 




Grid-Height (1 to 4095). 





Description 



The < set- graph text- font-gr id> command specifies the d imen- 
sions of the "grid" ( character cell) used for defining 
characters in a user-defined graphtex t character font . The 
width and height are tho se of an uppercase character . When 
the characters are displayed , the font grid width and height 
are used for seal ing the characters to fit the current 
graphtex t size . 

Thi s command must be given before any characters are defined 
in the specified font . ( An error occur s if any user-defined 
characters ex ist in the specified font . ) 

Once you have deleted all characters of that font ( with the 
<delete-graphtex t- char act er : font-number ? -1 > command) , then 
you may i ssue a < set graphtex t- font-gr id> command . 
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GRID WIDTH = 30 




AT (0,0) 



3675-27 

Figure 4-14. A Font Grid, With Two Characters Defined On That Grid 
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Def aul ts 

Parameter 
Number 

1 

2 

3 

Errors 



As Shipped 
From Factory 

None 

None 

None 



On Power-Up 

None 

None 
None 



If the Parameter 
is Omitted 



Error SG21 
Error SG31 



SG02 (Level 3) -Out of memory while defining font grid 
SG10 (Level 2): Font already exists. 



SG11 (Level 2) 

SG21 (Level 2) 

SG31 (Level 2) 
Re f er ences 



Invalid font number (must be in the range 
from to 32767) . 

Invalid grid width, (Must be in the range 
from 1 to 4095. ) 

Invalid grid height . ( Must be in the range 
from 1 to 4095.) 



<Open-graphtex t- char act er> 
<Del ete- char act er> 
<Close-gr aphtext- char act er> 
<Se t— graphtex .t- font> 
<Save-graphtex t-font> 
<Se t- graph text- si ze> 
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<Set-Graphtext-Precision> Command 



SYNTAX 




<set-graphtext-precision> : 


= (ESO(MMQ) 

<int : precisision> . 


PARAMETERS 




Precision (1 or 2). 




1 = "string precision" 

2 = "stroke precision" 




Description 



"String precision" ( precision mode 1) specifies that graph- 
text is d ispl ayed exactly as is unescorted alphatex t . The 
< set- graphtex t- font> , <set-graphtex t-si ze> , and < set- 
graph text- rotation>, commands have no effect . ( On a 4114, 
only the < set- alphatex t-si ze> and <set-401 4-alphatex t-si ze> 
commands affect the size of str ing precision graphtex t . ) 

"Stroke precision" ( mode 2) impl ies that graphtex t is dis- 
played according to the settings of the < se t-gr aphtex t- 
font> , < set- graph t ex t-si ze> , and < set- graphtex t- rota tion> 
commands . 
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Defaults 



Parameter 
Number 



As Shipped 
From Factory 



On Power-Up 



If the Parameter 
is Omitted 



2 



2 



Error MQ1 1 



Errors 



MQ11 (Level 2): Invalid precision mode (must be 1 or 2 ) . 
References 

<Set-graphtex t-font> command . 
<Set-graphtex t-si ze> command . 
<Set-401 4-alphatex t-si ze> command . 
<Set-alphatex t-font> command. 
<Set-alphatex t-si ze> command • 
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<Set-Gr aphtext-Rotation> Command 



SYNTAX 

<set-graphtext-rotation> = (ESC)(M)(R) 

<real: angle- in-degrees> . 

PARAMETERS 

Angle-In-Degrees (-32767.0 to +32767.0). The rotation 
angle in degrees, from the direction of the positive 
x-axis. Positive angles represent counterclockwise ro- 
tations, while negative angles represent clockwise 
rotations . 



Description 

Specifies the counterclockwise rotation angle (in degrees) 
for all subsequent graphtext strings displayed in "stroke 
precision" mode. 

Default is 0.0 degrees. 



Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 0.0 0.0 0.0 

Errors 



MR 1 1 (Level 2): Invalid rotation angle ( must be in the range 

from -32767.0 to +32767.0). 

References 

<Se t- graphtext- prec is ion> command . 



4110 SERIES COMMAND REFERENCE REV.DEC1981 



4-429 



ALPHABETICAL LISTING 



<Set-Graphtext-Size> Command 



SYNTAX 




<set-graphtext~size> = (ESC) (M) (C) 

<int : character- 
<int : character- 


wid th> 

he ight> 


<int : character- 


spac ing> . 


PARAMETERS 




Character-Width (1 to 4095) .Width of a 
character cell, in terminal space units 


graphtext 


Character-Height (1 to 4095)v Hei eht of 
character' cell , in terminal space units 


a graphtext 


Character-Spacing (0 to 4095). Spacing, 
space units, between adjacent character 
same graphtext string. 


in terminal 
cells in the 



Description 

The < set- graph t ex t- si ze> command determines the size of the 
character for subsequent stroke-precision graphtext. Values 
are specified in terminal space (4096 x 4096 space) units. 

The "character width 11 define the size of an uppercase 
character . The " inter- character spacing" determines the 
spacing between the lower right corner of one character cell 
and the lower left corner of the next succeeding character 
cell in the graphtext string. 
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Defaults 



Parameter 
Number 

1 



3 

Errors 



As Shipped 
From Factory 

39 in 4112, 

40 in 4114 

52 in 4112, 

60 in 4114 

13 in 4112, 

16 in 4114 



On Power-Up 



39 in 4112, 

40 in 4114 

52 in 4112, 
60 in 4114 

13 in 4112, 
16 in 4114 



If the Parameter 
is Omitted 

Error MC11 



Error MC21 



MC 1 1 (Level 2): Inv al id v alue in parameter 1 . ( Must be in 

the range from 1 to 4095.) 

MC21 (Level 2): Invalid value in parameter 2. (Must be in 

the range from 1 to 4095.) 

MC31 (Level 2): Invalid value in parameter 3 • (Must be in 

the range from to 4095.) 

Re ferences 

<Set-graphtex t-font-gr id> command. 
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<Set-Key-Execute-Character> Command 



SETUP Mode Name: KEYEXCHAR 



SYNTAX 

<set-key-execute-character> = (ESC) (K ) (Y )< in t> 

<in t : key-execute- 

char > . 
PARAMETERS 

Key-Execute-Char (0 to 127) . Numeric equivalent of the 
ASCII character which delimits the " execute locally" 
part of a macro definition . 



Description 

This command sets the value of the <key-execute-char ac ter> , 
used with the <def ine-macro> command . 

Normally , when the operator presses a key which has been 
programmed ( with the <def ine-macro> command) , the characters 
programmed into the key are sent to the host computer , just 
as if the operator had typed those characters manually . This 
includ es characters which comprise an "esc ape sequence" 
command for the terminal ; the terminal , instead of ex ecut ing 
such a command , sends the characters which compr ise it to 
the host. 

The < ke y-execute- char act er> provides a way around thi s prob- 
lem . Within a key definition , the <ke y-execute- char ac ter> 
marks the beginning and end of a sequence of characters 
which the terminal is to execute locally rather than send to 
the ho st . 
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The < key- execute- character^ has this special effect only 
when the macro containing it is invoked by pressing a key. 
If , instead , the macro is invoked with an < expand-macro> 
command, then the <key-execute-char ac ter> is treated 1 ike 
any other character in the macro definition . When a macro 
which was defined with a <def ine-macro> command is expanded 
by the operator pr essing the associated key , the contents of 
the macro are initially routed to the ho st computer . When a 
<key-execute-char ac ter> is encountered in the macro , it is 
d isc arded and the macro contents are routed to the terminal . 
Each subsequent <key-execute-char ac ter> encountered " tog- 
gles" the destination of the macro contents ( from terminal 
to host , or from host to terminal ) and is d isc arded ( not 
d ispl ayed or transmitted) . Note that when a macro is expand- 
ed by an <expand-macro> command , all the macro contents are 
always routed to the host . 



Def aul ts 

Parameter As Shipped On Po wer-Up If the Parameter 

Number From Factory is Omitted 

1 16 - (DLE) Remembered - (NUL) 

Errors 



KY11 (Level 2): Inv al id < key-execute- del imiter> code ( must 

be in range to 127) . 

References 

<De f ine-macro> command . 
<Ke y- execute- char act er> . 
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<Set-Image-Or ientation> Command 



SETUP Mode Name: HCORIENT 



SYNTAX 

<set-image-or iuntation> = (ESC) (Q) (0) 

<int : or ientation> 

PARAMETERS 

Orientation (0 - 3) . Selects the orientation of the 
hardcopy image with respect to the hardcopy media . 

= long axis of image on long axis of media 

1 = long ax is of image on short ax is of media , at 

bottom 

2 = long ax is of image on short ax is of media , 

centered 

3 = long axis of image on short ax is of media , at 

top 



Descr ipt ion 

The <set-image-or ientation> command sets the orientation of 
the hardcopy image with respect to the hardcopy media ( the 
paper or transparency on the hardcopy machine) . Figure 4-1 5a 
shows the possible orientations of the image with respect to 
the media. Figures 4-15aA through 4-1 5aD show the results of 
assigning orientations through 3, respectively . 



4113 
Option 9 
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B. 





IMAGE 



IMAGE 



C. 



MEDIA 



D. 



MEDIA 



3892-23 



Figure 4-15a. Orientation of Copier Images to Media • 



On the TEKTRONIX 4691 Color Graphics Copier , assigning 
orientations 1 through 3 are all equivalent to assigning 

orientation 2 (Figure 4~15aC)« 

This command is recognized only by a 4113 terminal with the 
Option 9 color hardcopy interface installed . The orientation 
of an image becomes apparent when the <hardcopy> command (or 
the HARD COPY key or <4010-hardcopy> command) is issued 
after a < select-hardcopy- inter face> command has chosen the 
Option 9 color hardcopy interface ♦ 



Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 Remembered 
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Er rors 



Q000 (Level 0): Unrecognized command (Option 9 is not in- 
stalled) . 

Q011 (Level 2): <Int> parameter out of range (0-3 are 

valid) . 

Ref erences 

<Hardcopy> command. 
HARDCOPY key • 

<Select-hardcopy-interf ace> command . 
<4010-hardcopy> command . 
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<Set-Line-Index> Command 



SYNTAX 

<set-line-index> = (ESC) (M) (L) 

<in t : 1 ine- index> . 

PARMETERS 

Line-Index (0 to 32767) . In a 4112 or 4113, this is 
the color-index with which subsequent 1 ines are to be 
drawn . In a 4114, the line index is stored in segments 
as graphic information , but is used only when drawing 
those segments on a plotter . ( See <map- index- to- pen> 
command . ) 



Description 

On a 4112 or 4113, the <set-line-index> command specifies 
the color-index with which subsequent 1 ines , panel 
boundaries , and markers are to be drawn . There is a maximum 
color-index for any particular sur face - one less than 2**M, 
where M is the number of bit planes assigned to that 
sur face . If the color-index in effect when a line is drawn 
is greater than the maxim urn index for the sur face , the line 
is drawn using the max imum index , instead . 

The actual intensity for each value depends on the current 
gray-level or color mixture for the par ticul ar color-index . 
For details , see the descriptions of the < set- sur face- gray- 
levels> and < set- sur face- col or-map> commands . 

On a 4114 the <set-line-index> command defines the pen index* 
for subsequent output to a plotter . (See the <map-index-to- 
pen> command for details . ) When drawn on the 4114 screen , 
all lines appear green , since that is the color of the 
screen 1 s phosphor . ) 
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Def aul ts 



Parameter 
Number 



As Shipped 
From Factory 



On Power-Up 



If the Parameter 
is Omitted 



4112: 7; 
4113: 1; 
4114: 255. 



41 12: 7; 
4113: 1; 
4114: 255. 







Errors 



ML11 (Level 2): Invalid line index, ( Must be in the range 

from to 32767.) 

References 

<Map- index- to-pen> command. 
<Plot> command . 

<Set-sur f ace-def initions> command. 
<Set-sur face-gray-levels> command. 
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<Set-Line-Style> Command 



•^1,'SXNTAX 

<set-])ine-style> = (ESC) ( M) ( V ) 

<int : 1 ine- style- number > 8 

PARAMETERS 

Line-Style-Number (0 to 7). "Zero" means " solid line 
Numbers from one to seven designate different types of 
dashed lines . 



De script ion 

The <set-line-style> command selects one of eight d if fer ent 
1 ine styles for sub sequent graphics : sol id 1 ines , dashed 
1 ines , etc . The defaul t 1 ine styl e on power-up is 1 ine style 
zero - solid 1 ines . (If the dialog area is not enabled , then 
a <page> resets the current 1 ine style to this defaul t . ) 

For purposes of defining segments , 1 ine style is deemed to 
be a pr imitive attr ibute ( an attr ibute of a graphic primi- 
tive)- As such , it cannot be changed once a segment has been 
defined . Once a segment has been defined , any 1 ine within 
that segment is always drawn in the same 1 ine style . 
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Figure 4-15 shows samples of the eight line styles. 

Line Style 

7 

4 

3 

2 

1 
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Figure 4-15. Line Styles. 
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Def aul ts 



( 



Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 

Errors 



MV11 (Level 2): Invalid line style. (Must be in the range 

from to 7 . ) 

References 

<Page> command . 

<Set-401 4-line-style> command . 
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<Set-Line-Width> Command 



4114 



SYNTAX 

<set-line-wid th> 
PARAMETERS 



(ESC) (M) (W) 
<int : wid th> 



Width (0 or 1). Zero selects narrow lines (the de- 
fault) , while one selects wide lines (defocused beam) 



Description 

The <set-line-wid th> command lets you defocus the 4 1 1 4 f s 
electron beam, so that it draws 1 ines which are wider than 
normal . The < int> parameter is zero for narrow 1 ines , and 
one for wide 1 ines ( defocused beam) . 



Defaults 

Parameter 
Number 

1 

Errors 



As Shipped 
From Factory 





On Power-Up 





If the Parameter 
is Omitted 





MW00 (Level 0): Unrecognized command . (The terminal is not a 

4114.) 

MW11 (Level 2): Invalid line width. ( Must be either or 1 . ) 



References 



<Set-401 4-line-width> command 
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<Set-Margins> Command 4114 



SETUP Mode Name: MARGIN 



SYNTAX 

<set-margins> = (ESC)(K)(M) 

<int : number-of-margins> . 

PARAMETERS 

Number- of-Mar gins (1 to 8). Specifies the number of 
margins ( or number of columns) which the 4114 uses 
when d ispl aying alphatex t outside the dialog area . 



Description 

The < set-margins> command determines the number of margins 
( or number of columns) which the terminal uses when d ispl ay- 
ing text on the screen . In doing so , it al so defines when it 
is that a "page full cond ition" occur s . 

One Margin • If <int> = 1 , the terminal has only one marg in : 
"margin 1," at the left edge of the screen . Each ( CR) moves 
the alpha cur so r to the left edge of the screen . Each (LF) 
moves the alpha cur so r down one line. Characters typed 
beyond the end of a 1 ine "wrap around" to the beginning of 
the next 1 ine , as if a ( CR) (LF) had been received . 

With only one margin , a " page full" condition occurs when 
the cur so r is already at the bottom of the screen and (LF) 
or " wrap-around" occur s . 
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More Than One Margin. If the < int> parameter is 2 , there are 
2 margins defined; if it is 3, there are 3 margins defined, 
and so on. The maximum number of margins is eight. 

With N margins in effect , the screen is divided into N 
columns of equal width . Margin 1 is at the left edge of the 
leftmost column; margin N is at the left edge of the 
r ightmost column . 

Initially , marg in 1 is "in effect . When the cur sor reaches 
the bottom of the screen , and (LF) or wrap-around cond ition 
occurs, the alpha cur sor moves to the top of column 2 , and 
marg in 2 goes into effect . Subsequent carriage returns ( or 
wrap-arounds) will move the cur sor left only to margin 2 ; 
the text in c o 1 urn n 1 will not be overwr itten . 

Likewi se , if more than 2 margins are defined , when the 
cur sor reaches the bottom of column 2 it advances to the top 
of column 3- Thi s continue s until the bottom of the 1 ast 
column is reached , whereupon a "page-f ull" cond ition occur s . 

Page-Full Condition • When a page-full cond ition occur s , the 
sub sequent action depends on the most recent < set-page- full- 
action> command : 

If the < set- page- f ull- action> command specified "no 
action , 11 then the alpha cur sor moves to the top of 
margin one . Subsequent alphatex t will over pr in t 
whatev er is already d ispl ayed on the screen . 

If some other action was specified in the <set-page- 
f ull-ac tion> command , then that other action occurs. 
See the description of the < set- page- f ull- actio n> com- 
mand for detail s . 
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( 

Defaults 



Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 2 2 Error KM 1 1 

Errors 



KMOO (Level 0): Unrecognized command. (The terminal is not a 

4114,) 

KM 1 1 (Level 2): Invalid number of margins (must be in the 

range from 1 to 8). 

Re f erences 

<CRLF> command . 
<LFCR> command . 
<Page> command . 
PAGE key. 

<Se t-page- full- action> command. 
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<Set-Marker-Type> Command 
SYMTAX 

<set-marker-type> = (ESC) (M) (M) 

< in t : mar ker-number > . 

PARAMETERS 

Marker-Number (0 to 10), Specifies which marker type 
is to be used when the terminal is pi aced in marker 
mode , or when a <draw-marker> command is issued. 



Description 

Specifies which marker is to appear when the terminal is put 
into marker mode : 



: 


A dot ( single point). 


1 : 


The period character . 


2 : 


A plus sign ( + ) . 


3 : 


An asterisk ( * ) . 


4 : 


The letter 0. 


5 : 


The letter X. 


6 : 


A square. 


7 : 


A d iamond . 


8 : 


A square with a dot in its center . 


9 : 


A diamond with dot in its center . 


10 : 


A square with d iagonal s . 
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Def aul ts 



Parameter 
Number 



As Shipped 
From Factory 



On Power-Up 



If the Parameter 

is Omitted 















Errors 



MM 1 1 (Level '2): Invalid marker type (must be in the range 

from to 10). 

References 

<En ter-mar ker-mode> command . 
<Dr aw-marker> command . 
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<Set-Number-of-Copies> Command 4113 

Option 9 



SETUP Mode Name: HCOPIES 



SYNTAX 

<set-number-of-copies> =(ESC) (Q) (N) 

<int+s number-of-copies> 

PARAMETERS 

Number-of-Coples (0 through 65535)* Selects the number 
of copies that are produced when a color hardcopy 
operation is invoked. 



Description 

The < set- number ~of-copies> command sets the number of copies 
that are produced each time a <hardcopy> or <4010-hardcopy> 
command is received or the HARDCOPY key is pressed , when the 
color copier interface has been selected with the Select- 
hard copy- inter face> command . 

If you assign zero as the parameter , one copy is produced . 

This command sets the number of hardcopies that are produced 
only for a 4113 terminal with the Option 9 color hardcopy 
interface installed . 



Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number . From Factory is Omitted 

1 None 1 
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Errors 



QNOO (Level 0): Unrecognized command (Option 9 is not in- 
stalled ) . 

QN11 (Level 2): <Int+> parameter out of range (0 through 

65535 are valid) . 

References 

<Hardcopy> command • 
HARDCOPY key. 

<Select-hardcopy~inter f ace> command . 
<4010-hardcopy> command ♦ 
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<Sefc«Page-Full«Acti©n> Command 



SETUP Mode Name: PAGEFULL 



SYNTAX 

<set-page-full-action> = (ESC) (K) (P) 

<int : page-f ull-action> . 

PARAMETERS 

Pagt-Full-Action (0 to 7) • Sets the page-full action, 
as follows : 



: No action « (SETUP mode keyword : NONE) 

1 : Wait for key push. (SETUP mode keyword : STOP) 

2 : Perform <hardcopy> , then 

<page>. (SETUP mode keyword : AUT0C0PY) 

3 : <Hardcopy> , then wait for key push , then 

<page> • (SETUP mode keyword : 3) 

4 : Send break signal to host. (SETUP mode keyword : BREAK) 

5 : Send break , then wait for key 

push. (SETUP mode keyword : 5) 

6 : Send break , then do <hardcopy> and 

<page> . (SETUP mode keyword : 6) 

7 : Send break , then do <hardcopy> then wait 

for key push , then <page> . (SETUP mode keyword : 7) 
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Description 

This command specifies the action (if any) which the termi- 
nal performs when a page-full condition occurs. A page-full 
condition occurs when the dialog area is disabled and the 
alpha cursor "wraps" off the bottom of the last margin in 
the graphics area* "Wrapping" occurs when the cursor is on 
the bottom line and the terminal receives a linefeed, or 
when the cursor is at the end of the bottom line and the 
terminal receives a printable character. 4112 and 4113 
terminals have only one margin. 4114 terminals can have up 
to eight margins, as set by the <set-margins> command. 

If < int> = , there is no page-full action . 

If <int> = 1, 3 , 5 , or 7 , output to the display is stopped 
until a key is pressed . 

If < int> = 2, 3t 6 , or 7> when a page-full condition occurs , 
an automatic hard copy is generated . If <int> r 2 or 6, then 
the screen is erased after the hard copy. If <int> = 3 Or 7 , 
the screen is erased after the hard copy and after a *c^> is 
pressed . 

If <int> = 4 , 5 , 6 , or 7 , a "break" is sent to the host , 
just as if the operator had pressed the BREAK key . 

Once set in a given mode , the page-f ull-action continues in 
that mode until it is specifically changed with another 
<set-page-f ul 1-act ion> command . 

Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

10 



Errors 

KP11 (Level 2) : Invalid page-ful 1-act ion code . ( Must be in 

the range from to 7 • ) 

References 

<Hardcopy> command . 
<Page> command . 
<Set-margins> command . 
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<Set-Panel-Filling-Mode> Command 



4112, 41 13 



SYNTAX 



<set-panel- f ill ing-mode> 



= (ESO(MHS) 

< in t : over str ike/repl ace> 
<int : cover-boundar y > 
<int : pattern-keying-mode> 



PARAMETERS 

Ov er str i ke/ Re pi ac e (0 or 1 ) . 

=■ repl ace mode 

1 = over str ike mode 

Cover-boundary (0 or 1 ) . 

= no 

1 = yes 

Pattern-Keying-Mode (0 to 3 ) • 

= no change to keying 

1 = keyed to viewport position 

2 = keyed to lower left panel pixel 

3 = keyed to absolute screen position 
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Description 

This command determines how subsequent panel s are to be 
filled. 

Over strike/ Replace . The " over str ike/ re pi ace" parameter 
determines the effect of zeroes in the fill pattern. If this 
parameter is one ( "over str ike" ) , then when subsequent panels 
are filled , pixels in the panel interior which correspond to 
zeroes in the fill pattern are 1 ef t unchanged . If , however , 
the over str ike/ repl ace parameter is zero ( "repl ace" ) , then 
when subsequent panels are filled , zeroes in the fill 
pattern cause the correspond ing pixels in the panel interior 
to be set to color- index . Figure 4-16 shows the effect of 
the over str ike/ repl ace parameter . 
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A. Replace Mode. 
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B. Overstrike Mode. 
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Figure 4-16. Effect of overatr ike/Replace Parameter. 
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Fill Boundary, The "fill boundary" parameter determines 
whether j when panels are filled, their boundaries are filled 
as well as their inter irors . If this parameter is zero , only 
panel interiors will be filled; if one , then both the 
interiors and the boundaries are filled. 

If a < beg in- panel- bound ary> command specifies that the panel 
boundary is to be drawn , but the < set- pan el- f ill ing-mode> 
command specifies that the filling operation is to include 
the boundary as well as the interior, then the "filling the 
boundary" will supercede "drawing the boundary.," That is, 
the boundary is first drawn, and then later (when an < end- 
panel> command is received) , it is covered over with the 
f il 1 pattern . 



Pattern Keying . The " pattern keying" parameter determines 
how the fill pattern itsel f is positioned within a panel 
being filled . 

If this parameter is zero , the present pattern keying mode 
is not changed . 

If this parameter is one , the fill pattern is "keyed to the 
current viewport." Figure 4-17 shows the concept. The fill 
pattern to be used is r epl icated over the entire v iewpor t , 
starting at the lower left corner of the viewport . Then that 
part of the ( repl icated) fill pattern which falls within the 
panel to be filled is used to fill the panel . 
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VIEWPORT TWO 



VIEWPORT ONE 



Mmmc __ i ^^ 3892-18 

Figure 4-17. Keying a Fill Pattern to the Current Viewport. 



If the "pattern keying" parameter is two, then the fill 
pattern is keyed to the leftmost pixel in the bottom row of 
pixels in the panel being filled. The process is the same as 
described above, except that when replicating the fill 
pattern, the terminal starts at the lower left corner of the 
panel rather than the lower left corner of the current 
viewport. Figure 4-18 shows the result. 
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VIEWPORT TWO 
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Figure 4-18. Keying a Pattern to the Panel Being Filled. 



If the 11 pattern keying" parameter is three , then the fill 
pattern is keyed to the lower left corner of the screen . The 
process is as before, except that , wh en repl icating the fill 
pattern , the 4112 starts at the lower left corner of raster 
memory space ( rather than the lower left corner of the 
v iewpor t or the leftmost pixel in the bottom line of the 
panel being filled) . Figure 4-19 shows the effect . 



4-452 



rev, dec 1981 4110 SERIES COMMAND REFERENCE 



ALPHABETICAL LISTING 























- ; ^ ; 








VIEWPORT TWO 






% ; 




































'AVvVVVV 










■„-- v. " - V 




s. % i V 




' v - -. • ' - 












-v'V-'vV 
\Vvv 


















\ ^ x n. 

' % ' 


\ V N. N 1. -r -r 






















VIEWPORT ONE 










1 ^ \ t i i ^ 























3892-18 

Figure 4-19. Keying a Fill Pattern to the Screen. 



When keying to the viewport or to the screen , panel s join 
each other smoothly , with no discernable interruption in the 
fill pattern . When keying to the panel being filled , how- 
ever , each panel is filled starting at the leftmost pixel of 
that panel 1 s bottom line , so there will usually be a "jump" 
or interruption in the fill pattern at the boundaries 
between adjacent panels . 
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Defaults 

Parameter 
Number 

1 

2 ■ 
3 

Errors 



As Shipped 
From Factory 





1 



On Power-Up 



1 



If the Parameter 
is Omitted 









MSOO (Level 2): Unrecognized command . (Terminal is not a 

4112 or a 4113.) 

MS11 (Level 2): Invalid over str ike/repl ace mode parameter 

(must be or 1), 

MS21 (Level 2) ; Invalid boundary-filling mode parameter 

( must be or 1 ) . 

MS31 (Level 2): Invalid pattern keying value (must be 0, 1, 

2, or 3). 

References 



<Begin- fill- patter n> command, 
<Begin-panel-boundar y> command . 
<End-panel> command , 



c 
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<Se t-Par ity> Command 



SETUP Mode Name: PARITY 



SYNTAX 


<set- 


parity> = (ESC) (N)(P) 

< int : par ity-mode> . 


PARAMETERS 


Parity-Mode (0 to 4) . 


= 


NONE ; the terminal ingores par ity in character 
it receives from the host , and sets the parity 
b it to zero in characters it sends to the host . 


1 = 


ODD ; the terminal ignores parity in characters 
it receives , but uses odd parity in characters 
it transmits to the host . 


2 = 


EVEN; the terminal ignores par ity in characters 
it receives , but uses even par ity in characters 
it transmits . 


3 = 


HIGH ; the terminal ignores par ity in characters 
it receives , and sets the par ity b it to one in 
characters it transmits . 


4 = 


DATA ; the terminal uses the eighth bit in each 
character as another data bit . 



Description 

PI aces the terminal in the spec if ied parity mode . The < int> 
has a range of values of through 4. 

This command determines how the parity bit is set in 
characters which the terminal sends to the host . (The 
terminal ignores the par ity b it in characters it receives 
from the host . ) 
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Parity NONE • If mode (NONE) is selected, the terminal sets 
the par ity bit to zero in characters it sends to the host . 

ODD Parity. If mode 1 (ODD) is selected , then when the 
terminal sends a character to the host , it sets the parity 
bit in that character to one or zero , whichever is required 
so that the character will have an odd number of bits set to 
one . 

EVEN Parity. If mode 2 (EVEN) is selected, then the terminal 
sets the par ity b it to one or zero , whichever is required so 
that the character will have even par ity . 

HIGH Parity. If mode 3 (HIGH) is selected , then the termi- 
nal , when send ing a character to the host , sets the parity 
bit to one . 

DATA Parity. If mode 4 (DATA) is selected , then the terminal 
uses the eighth bit in each character as another data bit . 
(This is only useful when the terminal is using another 
telegraph code than the seven-bit ASCII code . For instance , 
DATA parity might be used when tr ansf err ing binary f iles 
between the host and the terminal . ) 



Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 Remembered 

Errors 



NP11 (Level 2): Inval id parity code • (Must be in the range 

from to 4 . ) 

References 

<Se t-port-par ity> command . 
<Set- snoopy-mod e> command . 
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<Set-Pick-Aperture> Command 



SYNTAX 




< set- pick-ape rture> : 


= (ESO(I)U) 




< int : aperture-width> . 


PARAMETERS 




Aperture-width (0 to 


4095). 



Description 



This command sets the si ze of the pick aperture . 

Explanation . The pick aperture is a square in terminal 
space , centered on the current beam position . Dur ing a GIN 
pick operation part of the segment picked must fall within 
the pick aperture . (See <enable-GIN> command and <GIN-pick- 
report> for details . ) 

The width parameter sets the width of the pick aperture 
square , in "terminal space" units . If the width is zero , 
then part of the segment being picked must fall exactly at 
the current cursor position . If the width is 4, then part of 
the segment being picked must have its x-coord inate in the 
range from XO-2 to XO+2 , and its y-coordinate in the range 
from YO-2 to YO+2 , where (X0, Y0) is the current beam 
position . 

The width parameter may be any < int> in the range from to 
4095 . If the parameter is omitted ( by terminating the 
command early) , the terminal assumes a value of zero . Very 
large pick apertures , although allowed , are impractical . 
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( 

In the 4112 and 4113, the specified size of the pick 
aperture is an approximate number. Because of the rounding 
that occurs when transforming coordinates from terminal 
space to raster memory space (and vice-versa) , it is possi- 
ble to pick a line that is slightly outside the stated 
aperture . 



Defaults 



Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

18 8 



Errors 



IA 1 1 (Level 1): Invalid aperture width ( must be in the range 

from to 4095) * 

References 

<Enable-»GIN> command, 

<GIN~pick~repor t> syntactic construct. 
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<Set-Pick-ID> Command 



SYNTAX 




<set-pick-ID> = 


: (ESC)(M)(I) 




< int : pick-ID-nuraber> . 


PARAMETERS 




Pick-ID-Number 


(0 to 32767). 



Description 

When a segment is "picked" during a graphic input operation, 
the pick identification number for the portion of the 
segment within the pick aperture is returned to the host 
computer. This permits the host computer to know, not only 
which segment the operator picked, but also which part of 
the segment was picked. 

The < se t-pick-ID> command inserts a f 1 ag into the d ispl ay 
1 ist for the segment being defined , to mark the nex t 
available position to be used for picking operations . The 
< set-pick-ID> command is considered a graphic pr imitive ; 
however , unl ike other graphic pr imitives , it has no d irec t 
effect on the appearance of a pic tur e . 

If , during the pick operation , the pick aperture is so large 
as to cover parts of the segment with d if f erent pick-ID 
numbers , then the terminal returns the last of the pick-IDs 
in the d ispl ay 1 ist for parts of the segment within the pick 
aperture . If , on the other hand , no visible , detec tabl e 
segment falls within the pick aperture , the terminal sends a 
<GIN-pick-report> in which the pick-ID number is zero . 

The pick-ID number s are arbitrary integers in the range from 
zero to +32767 . However , only those parts of a segment which 
are flagged with positive pick-ID numbers can be picked . A 
zero pick-ID number marks a part of a segment which c anno t 
be picked . The default pick-ID is one . 
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At the start of a segment definition ( immediately after the 
<begin-segment> command , the pick-ID number is one . While 
defining the segment, you can issue <set-pick-ID> commands 
to label subsequent parts of the segment with d if ferent 
pick-ID numbers . 

NOTE 

To make it easier to create "menus , " the 
<includ e-copy-of-segment> command does 
not copy the initial ( assumed) pick-ID. 

The flags inserted in the segment by <set-pick-ID> commands 
are deemed to be graphic pr imitives . As such , they are 
permanent parts of the segment and cannot be changed once 
the segment has been defined . Therefore , the <set-pick-ID> 
command is only valid while a segment is being defined . If 
you i ssue a < set-pick-ID> command while no segment is 
currently being defined , the terminal detects a type MI03 
error . 



Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 1 1 

Errors 



MI03 (Level 2): Command is inval id at this time . (No segment 

is currently being defined . ) 

M1 1 1 (Level 2): Invalid pick identification number . ( Must be 

in the range from to- 32767.) 

References 

<Begin-segment> command . 
<Enable-GIN> command. 

<GIN-pick-report> syntactic construct. 
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<Set-Pivot-Point> Command 



SYNTAX 

<set-pivot-point> = (ESC)(S)(P) 

<xy : pivot- point > . 

PARAMETERS 

Pivot-Point (X = to 4095, Y = to 4095). Specifies 
the pivot point for subsequent segment definitions and 
graphtex t characters definitions . 



Description 

This command specifies the pivot point for all segments and 
graphtext characters which subsequently are defined. 

For segments , the pivot po int is po in t within the segment 
which defines the "position" of the segment when that 
segment is displayed . If a < set-segment-position> or <set- 
segment- image- tr an sform> specifies a new position for the 
segment , it is the pivot po int within the segment which 
appears at that new position . 

If a segment is used as the graphic cur sor , it is the 
segment's pivot po int which replaces the intersection of the 
crosshair s in the default crosshair cur sor . 

For graphtext characters , the pivot po int is the po int which 
defines the " lower left corner" of the character cell when 
the character is later d ispl ayed . Within the character 
definition , the character cell extends from the pivot point 
to the right by "width" terminal space un its , and from the 
pivot po int upward by "height" units , where "width" and 
"height" are determined by the most recent < se t-gr aphtex t- 
font-grid> command . 
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c 

The pivot point is a static attribute; once a segment (or 
graphtext character) has been defined, its pivot point 
cannot be changed. 

The pivot point is the point at which subsequent graphic 
objects and segments begin. For image transforms (see < set- 
segment- image- tr ansf orm> command), the pivot point is the 
point around which rotation occurs and about which all 
scaling occurs in both x- and y-dir ec tions . 

When a segment is created ( < beg in- segment > command), its 
pivot point and its position attribute both are set to the 
position specified by the most recent <set-pivot-point> 
command. The pivot point for that segment cannot thereafter 
be changed. (However, once the segment has ended (with an 
<end-segment> command), the segment's position can be 
changed with < set- segment- po si tion> or < set- segment- image- 
tr ansf orm> commands . ) 



Def aul ts 



Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted ^ 

1 (0,0) (0,0) (0,0) 



Errors 



No errors are detected for this command . 
References 

<Beg in- graphtext- character > command . 
<Begin-segment> command. 
<Se t-GIN-cur sor> command . 
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<Set-Pix el-Be am-Po si tion> Command 



4112, 4113 



SYNTAX 



<set-pixel-beam-position> = (ESC) (R ) (H ) 

<xy : beam-position> 



PARAMETERS 

Beam-Position (X = to 4095, Y = to 4095) • 

Position , relative to the pixel viewport 1 s lower left 
corner , where the next <raster-wr ite> or <runleng th- 
wr ite> command will take effect. 



Description 

This command sets the "pixel beam position" in the pixel 
v iewpor t , for use by subsequent <r aster-wr ite> or <run- 
leng th-wr ite> commands . The pixel beam position coord inates 
are relative to the lower left corner of the pixel v iewpor t 
in raster memory space . 

The <begin-pixel-operations> and < set- pi x el- v iewpor t> com- 
mand s initial ize the pixel beam position to the upper left 
corner of the pixel v iewpor t . 

If the pixel beam position is outside the current pixel 
v iewpor t ( or fill pattern rectangle) , then it is moved to 
the nearest pixel within the pixel viewport . 



Def aul ts 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 



(0,479) 



(0,479) 



(0,0) 
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Errors 



RHOO (Level 0): Unrecognized command, (The terminal is not a 

41 12 or a 41 13. ) 

References 

<Beg in- pixel- operation s> command . 
<Se t-pixel- viewpor t> command . 
<Raster-wr ite> command . 
<Runlength-wr ite> command. 
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<Set-Pixel-Viewport> Command 4112, 4113 



SYNTAX 

< set- pixel- viewports = (ESC) (R ) (S ) 

<xy : lower-lef t > 
<xy : upper-right> . 

PARAMETERS 

Lower-Left (X s to 639, Y = to 479) . Specifies, in 
raster memory space coord inates , one corner of the 
pix el v iewpor t . 

Upper-Right (X = to 639, Y = to 479) . Specifies 
the opposite corner of the pixel v iewpor t . 



Description 

This command sets the pix el v iewpor t position on the pix el- 
operations wr it ing surface . (The "pixel -ope rations wr iting 
sur face" is the sur face named in the most recent <begin- 
pixel-oper at ions> command . The < set-pixel- v iewpor t> command 
also upd ates the current pixel beam position to the upper 
left corner of the pixel v iewpor t . 

The " lower left" and " upper right" coordinates are in 640 by 
480 raster memory space . If an x-coordinate greater than 
639 , or a y-cord inate greater than 479 , is specified , then 
the terminal detects an error . 

The " lower left" and "upper right" coord inates may actually 
be the coord inates of any two d iagonally opposite corners of 
the pix el v iewpor t . The terminal will set Xmin ( the x- 
coord inate of the leftmost pixel in the pixel viewport) to 
the 1 esser of the two specified x-coord inates . It will set 
Xmax ( the x-coord inate of the rightmost pixel ) to the larger 
of the two x-coord inates . Likewi se , it will sort the y- 
coordinates in the proper order to determine the y-coordi- 
nates of the bottom and top of the pixel viewport . 
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Def aul ts 



Parameter 
Number 



As Shipped 
From Factory 



On Power-Up 



If the Parameter 
is Omitted 



(0,0) 



Remembered 



(0,0) 



2 



(639,479) 



Remembered 



(0,0) 



Errors 



RS00 (Level 0): Unrecognized command . (The terminal is not a 

4112 or a 4113.) 

RS 1 1 (Level 2): Invalid n lower left" coord inate . (X must be 

in the range from to 639 , and Y in the 
range from to 479.) 

RS21 (Level 2): Invalid "upper right" coord inate , (X must be 

in the range from to 639 , and Y in the 
range from to 479.) 

References 

<Beg in- pixel- operation s> command . 
<Se t- pixel- beam- posit ion> command . 
<Raster-wr ite> command . 
<Runleng th-wr ite> command . 



( 
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<Set-Port-Baud-Rate> Command (Option 10) 

SETUP Mode Name: PBAUD 
SYNTAX 

<set-port-baud-rate> = (ESC) (P)(R) 

< string: port-name ) 
<int : baud-rate > . 

PARAMETERS 

Port-Name ("P0:", ff P1: fl , or ,f P2: ff ) . Names the RS-232. 
peripheral port whose baud rate is being specified . 



Baud Rate . The data rate ( bits/second) used at the 
specified peripheral port . Val id rates are : 50, 75 , 
110, 134, 150, 300, 600, 1200, 1800, 2000, 2400, 3600, 
4800, 7200, and 9600/ 



Description 



This command sets the baud rate used at one of the three RS- 
232 per ipheral ports . The terminal "remembers" this setting 
even when powered off. (When shipped from the factory , the 
port-baud-rate setting is 2400 bits/ sec . ) 



Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 None None Error PR 1 1 

2 2400 Remembered Error PR21 
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Errors 



PROO (Level 0): Unrecognized command. (Option 1 is not 

installed) . 

PR 11 (Level 2): Invalid port identifier (must be "P0:", "P1: 

" , or "P2: ") . 

PR 1 2 (Level 3): Parameter 1 memory error . (Out of memory 

while parsing the port name str ing . ) 

PR13 (Level 2): Port is busy. 

PR21 (Level 2): Invalid baud rate (must be 50, 75, 110, 134, 

150, 300, 600, 1200, 1800, 2000, 2400, 3600, 
4800, 7200, or 9600). 

References 



<Set-baud-rates> command 
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<Set-Port-EOF-String> Command (Option 10) 



SETUP Mode Name: PEOF 



SYNTAX 

<set-port-EOF-string> = (ESC)(P)(E) 

<str ing : por t-name> 
<int-array : EOF-str ing> . 

PARAMETERS 

Port-Name ("PO:" , "P1: 11 , or lf P2: lf ) . Names the 
peripheral port for which an end-of-f ile str ing is 
being specified . 

EOF -Str ing • An array of up to ten < int> parameters • 
Each represents a single ASCII character , and so must 
be in the range from to 127. 



De script ion 

This command sets the end-of-f ile str ing used when a peri- 
pheral dev ice is connected to the specified RS-232 per ipher- 
al por t . When , during a <copy> to that dev ice , and end-of- 
f ile cond ition (EOF) is detected , the terminal sends the 
specified end-of- file str ing and terminates the <copy> oper- 
ation . 

Likewi se , during a or from a peripheral por t , the EOF-str ing 
marks the end of the <copy> or <pcopy> operation . That is , 
the terminal terminates the <copy> or <pcopy> when it 
detects the DOF-str ing in the characters coming from the 
peripheral dev ice . 

Port Name. The first parameter in the < se t-por t-EOF-str ing> 
command is a <str ing> naming the peripheral por t . This must 
be "PO:", "P1:", or "P2:". 
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End-of-File String. The command's second parameter is an 
< int-arr ay> holding the numeric equivalents of the 
characters which comprise the EOF-str ing . Each < in t> in this 
array is the numeric equivalent of an ASCII character , and 
so must be in the range from to 127- There may be as many 
as ten < int> s in the array . 



Defaults 

Parameter 
Number 

1 

2 



As Shipped 
From Factory 

None 

Empty array 



On Power-Up 

None 

Remembered 



If the Parameter 
is Omitted 

Error PE 1 1 

Empty str ing 



Errors 



PEOO (Level 0); 

PE 1 1 (Level 2); 

PE12 (Level 3) 

PE13 (Level 2) 
PE21 (Level 2) 

PE22 (Level 3) 



Unrecognized command . (Option 10 is not 
installed ) . 

Invalid port identifier ( must be "P0: n , "P 1 : 
" , or "P2: ") . 

Parameter 1 memory error . (Out of memory 
while parsing the the port name < str ing> . ) 

Port is busy. 

Inval id EOF str ing . (The < int-arr ay> must 
have from to 1 elements , and each < int> 
in the array must be in the range from to 
127.) 

Parameter 2 memory error . (Out of memory 
while parsing the end-of= file str ing < int- 
arr ay> . 



( 



References 



<Se t-EOF-str ing> command . 



( 
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<Set-Port-EOL-String> Command 



(Option 10) 



SETUP Mode Name: PEOL 



SYNTAX 



<set-por t-EOL- string > = 



(ESC)(P)(M) 

<str ing : port-name> 

< in t- array: EOL-str ing> 



"PI:" , or M P2: ,f ) . Names the RS-232 



PARAMETERS 
Port-Name ("PO: 

peripheral port for which an EOL-str ing is being 
spec if ied . 

EOL-String ♦ An array of up to two < int> parameters . 
Each < in t> is the numeric equivalent of a single ASCII 
character , and so must be in the range from to 127. 



Description 

Sets the end-of-line str ing for the specified por t . This 
str ing is sent out the port after a message with the EOM bit 
set is transmitted . Typic ally , this would be just the single 
character , ( CR ) , or the pair of characters , ( CR) (LF) . 



Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 None None Error PM 1 1 

2 Empty array Remembered Empty array 
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Errors 

PMOO (Level 0): Unrecognized command. (Option 10 is not 

installed . ) 

PM11 (Level 2): Invalid port identifier. (Must be "P0: ff ? 

f! P1:% or "P2:".) 

PM 1 2 (Level 3 ) : Parameter 1 memory error . (Out of memory 

while parsing the port name <str ing> . ) 

PM13 (Level 2): Port is busy. 

PM22 (Level 3)- Parameter 2 memory error . (Out of memory 

while parsing the EOL-str ing < int-arr.ay> . ) 

Re f erences 
None . 
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<Set-Port-Flagging-Mode> Command 



(Option 10) 



SETUP Mode Name: PFLAG 



SYNTAX 



<set-por t- flagging -mod e> 



= (ESC)(P)(F) 



<string: por t-name> 
<int : f lagging-mode > 
<int : GO-charac ter> 



<int : STOP-character> 



PARAMETERS 

Port-Name ( ,! P0: tf , W P1: W , or ,f P2: !l ). Names the RS-232 
peripheral port for which a flagging mode is being 
specified . 

Flagging-Mode (0, 1, or 2) . 

= NONE ; no flagging . 

1 = CHAR ; character f 1 agging . 

2 = DTR/CTS ; flagging with DTR, CTS signal lines. 

GO-Character (0 to 127) . The numeric equivalent of a 
single ASCII character . In CHAR fl agging mode ( mode 
1 ) , this character means , "I am ready for more data ; 
go ahead and send it." 

STOP-Character (0 to 127) . The numeric equivalent of a 
single ASCII character . In CHAR flagging mode , this 
character means , "1 am not ready for data ; stop 
send ing data to me." 



Description 

Sets the flagging mode for the specified host port number to 
which the per ipheral will be attached . 
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Character Flagging* When the terminal sends data to a 
peripheral device, that device can signal that it is not 
ready for more characters by sending a 11 stop" character . The 
terminal then stops sending characters to the peripheral 
device; it resumes transmission only on receipt of a 11 go" 
character from the peripheral device. 

Likewise ? when receiving data from a peripheral device , the 
terminal may send a "stop" character to the peripheral 
device when it is not yet ready to receive more characters. 
When the terminal is ready , it sends the "go" character to 
the peripheral device, causing the peripheral device to 
resume transmission. 

This flagging mode is the default mode, with (DC 1 ) - ASCII 
decimal equivalent 17 - as the "go" character, and (DC3) - 
ADE 19 - as the "stop" character. If the third parameter is 
zero (or omitted by terminating the command early), the 
terminal sets the "go" character to (DC 1 ) . If the fourth 
parameter is zero (or omitted ) , the terminal sets the "stop" 
character to (DC3 ) . 

DTR/ CTS Flagging. In send ing data to a peripheral device 
(typically, a printer for this kind of flagging), the 
terminal continues to send characters so long as the peri- 
pheral device places a positive voltage on the DTR (Data 
Terminal Ready) line at the RS-232 connector for that 
peripheral device* If the printer (or other peripheral 
device) places a negative voltage on DTR, the terminal stops 
sending characters until DTR goes positive again. 

In receiv ing data from a peripheral device, the terminal 
places a positive voltage on the CTS (Clear To Send) line at 
the RS-232 connector for that peripheral device. Should the 
terminal momentarily be "too busy" to receive characters, it 
places a negative voltage on CTS. This should cause the 
peripheral device to stop transmitting characters. When the 
terminal is ready to receive more characters, it sends CTS- 
positive again . 
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Def aul ts 



Parameter 
Number 

1 

2 

3 

4 

Errors 



As Shipped 
From Factory 

None 

1 

17 - (DC 1 ) 
19 - (DC3) 



On Power-Up 
None 

Remembered 
Remembered 
Remembered 



If the Parameter 
is Omitted 

Error PF 1 1 



17 - (DC 1 ) 
19 - (DC3) 



PFOO (Level 0): 

PF11 (Level 2): 

PF12 (Level 3): 

PF21 (Level 2) 

PF31 (Level 2) 

PF41 (Level 2) 
References 



Unrecognized command, (Option 10 is not 
installed.) 

Port is busy, or port identifier is invalid 
(must be "P0:", "P1:", or "P2:"). 

Parameter 1 memory error. (Out of memory 
while parsing the port name <str ing> . ) 

Invalid flagging mode (must be 0,1 or 2). 

Invalid "GO" character (must be in range 
to 127). 

Invalid "STOP" character (must be in range 
to 127; if non-zero, must be different from 
the "GO" character) . 



<Se t- f lagging > command 
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<Set-Port-Parity> Command (Option 10) 



SETUP Mode Name: PPARITY 



SYNTAX 

<set-port-parity> = (ESC)(P)(P) 

<string : port~name> 
<int : par ity-mode> . 

PARAMETERS 

Port-Name ("P0: ff , "P1: fl , or "P2: ff ) . Names the RS-232 
peripheral port whose parity mode is being specified . 

Parity-Mode (0 to 4). 

= LOW; the parity bit is set to zero . 

1 = ODD 

2 = EVEN 

3 = HIGH ; the parity bit is set to one . 

4 = NONE ; the parity bit is omitted . 



Description 

The < set-port-par ity> command determines whether characters 
at the peripheral ports have par ity bits . If the characters 
do have parity bits , the < set-port-par ity> command al so 
spec if ies how those par ity bits are set . 

NOTE 

The meaning of the "parity type" parame- 
ter in this command is not the same as 
the meaning of the correspond ing parame- 
ter in the < set-par ity> command . 
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Figure 4-20 shows the format of characters exchanged between 
the terminal and a device attached to an RS-232 peripheral 
port. Each character begins with a start bit . After the 
start bit come from 5 to 8 data bits , an optional parity 
bit , and one or two stop bits . The start bit is always zero 
( "space" or " travail" cond ition on the data communications 
line) . The stop bits are always one ( "mark" or "repos" 
cond ition) . The numbers of data bits and of stop bits are 
determined by the < set-port-stop-bits> command . Whether or 
not there is a par ity bit is determined by the < se t-por t- 
par ity> command . 

Port Specifier String . The <set-por t-par ity> command 1 s first 
parameter is a <string> naming the peripheral port whose 
parity attr ibute is being set . This parameter may be " P : " , 

"P1:" ? or "P2:". 

Parity Type . The command 1 s second parameter specifies the 
parity type . 

If the parity type parameter is zero , then low parity is 
used at the peripheral port. Each character includes a 
parity bit . The terminal transmits this bit as a "0," and 
ignores this bit in characters it receives from a peripheral 
dev ice . 

If this parameter is 1, then odd parity is used at the 
specified peripheral port. Each character ( or other six- , 
seven- , or eight-bit data byte) includes a parity bit . In 
transmitting characters to a peripheral dev ice , the terminal 
sets this bit to 1 or 0, whichever is needed to give an odd 
number of "1" bits ( not counting the start and stop bits) . 
Likewi se , when receiv ing characters from a dev ice at the 
peripheral por t , the terminal checks for odd parity . That 
is , it checks that there are an odd number of "1" bits ( not 
counting the start and stop bits) . 

If the parity type parameter is 2, then even parity is used 
at the peripheral port . Each transmitted character includes 
a parity bit . The parity bit is 1 or 0, whichever is 
necessary to make the character have an even number of "1" 
bits ( not counting the start and stop bits) . Again , the 
terminal checks for even parity in the characters it 
receives , and detects an error if' a received character does 
not have even parity. 
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THE COMMUNICATIONS LINE IS IN MARK' CONDITION 
UNTIL THE CHARACTER BEGINS WITH A START BIT. 



MARK 



SPACE 



START BIT"" 
(ALWAYS 'SPACE') 



THE LINE REMAINS IN 'MARK' CONDITION 
UNTIL THE START OF THE NEXT CHARACTER. 



I I I I I I I I I I I I 



— _ — ^ ^^— ^^^ 

5,6,7, OR S DATA BITS, 
AS DETERMINED BY THE 
<SET-»PORT-STOP-BITS> 
COMMAND. 



OR 2 STOP BITS, 
AS DETERMINED BY THE 
< $ET~PGRT»STOP«BITS> 
COMMAND. 



PARITY BIT 



3892-19 



Figure 4-20. Format of a Character at the RS-232 Peripheral Ports*^ 



If the parity type parameter is 3$ then high parity is used 
at the peripheral port. Each character includes a parity 
bit. The terminal always transmits this bit as a !f 1 f V* The 
parity bit is ignored in characters received from a peri- 
pheral device. 

If this parameter is. 4," the parity bit is omitted . 



( 
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For normal operation with the ASCII character set , there 
should be seven data bits, one parity bit, and one or two 
stop bits. Therefore, the <set-por t-par it y> command should 
have a parity mode parameter of 0, 1,2, or 3 • (Parity mode 
4 should be avoided, as that causes the parity bit to be 
omitted . ) 



Defaults 



Parameter 
Number 

1 

2 

Errors 



As Shipped 
From Factory 

None 

4 



On Power-Up 
None 

Remembered 



If the Parameter 
is Omitted 

Error PP11 





PP00 (Level 0): Unrecognized command. (Option 10 is not 

installed ) . 

PP11 (Level 2): Invalid port specifier is invalid (must be 

"P0:", "P1:", or f? P2:") . 

PP12 (Level 3 ) : Parameter 1 memory error. (Out of memory 

while parsing the port name <string>.) 

PP13 (Level 2): Port is busy. 

PP21 (Level 2): Invalid parity code (must be in range to 

4). 

References 

<Se t-par ity> command . 
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<Set-Port-Stop-Bits> Command 

SETUP Mode Name: PBITS 
SYNTAX 



(Option 10) 



<set-port-stop-bits> = (ESC) (P ) (B) 

< string: por t-name > 

<int : n umber- o f- stop- bit s> 

< int : n urn ber-of -data- bit s> . 

PARAMETERS 

Port-Name ("PO:", "P1: ff , or "P2:") . Names the RS-232 
peripheral port for which the numbers of stop bits and 
data bits are being specified . 

Number-Of-Stop-Bits (1 or 2). 

Number-Of-Data-Bits (5 , 6, or 7 ) . This count does not 
include the parity bit , whose presence or absence is 
determined by the < set-por t-par ity> command . 



Description 



The < set-por t- stop- bit s> command sets the number of stop 
bits and data bits used in characters sent between the 
terminal and its RS-232 peripheral ports . Thi s command 
requires that Option 1 be installed . 
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Figure 4-21 shows the format of a character (or data byte) 
transmitted between the terminal and one of its RS-232 
peripheral ports . Each character has a start bit, which is 
always (a positive voltage, corresponding to the "space" 
or "travail" condition at the RS-232 interface) . After the 
start bit come from 5 to 8 data bits ; the number of data 
b its is determined by the most-recent < set- port- stop- bit s> 
command . After the data bits comes the parity bit ; this bit 
may be omitted , depend ing on the most-recent < set- port- 
par ity> command . After the parity bit comes one or two stop 
bits . The number of stop bits is determined by the most- 
recent < set-por t- stop- bit s> command . The stop bits are al- 
ways 1 ( a negative voltage , correspond ing to a "mark" or 
" repos" cond ition at the RS-232 interface) . 



THE COMMUNICATIONS LINE IS IN 'MARK' CONDITION 
UNTIL THE CHARACTER BEGINS WITH A START BIT. 



THE LINE REMAINS IN MARK' CONDITION 
UNTIL THE START OF THE NEXT CHARACTER. 



I I 



MARK 



I I I I 



I I 



SPACE 



START BIT' 
(ALWAYS SPACE ) 



— — — ' — 

5,6,7, OR 8 DATA BITS, 
AS DETERMINED BY THE 
<SET-PORT-STOP-BITS> 
COMMAND. 



OR 2 STOP BITS, 
AS DETERMINED BY THE 
< SET-PORT-STOP-BITS> 
COMMAND. 



PARITY BIT 



| . a 3892-19 

Figure 4-21 . Format of Characters at the RS-232 Peripheral Ports. 
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Port Name » The first parameter in the < set- port- stop- bit s> 
command is a string naming the RS-232 peripheral port to 
which the command applies. This may be <string : " P : " > , 
<string : ff P1: !f > 9 or < string : "P2: »> . 

Number of Stop Bits, The second parameter is an <int> naming 
the number of stop bits. This parameter must be either 1 or 

2. . ' ' ■ 

Number of Data Bits. The third parameter is an <int>. naming 
the number of data bits. This parameter must be 5 , 6 , 7, or 

s. ■ 



( 



De f aul ts 



Parameter 
Number 

1 

2 : 

3 

Errors 



As Shipped 
From Factory 

None 

2 ■ .- 
8 



On Power-Up 

None 

Remembered 
Remembered 



If the Parameter 
is Omitted 

Error PB1 1 

Error PB21 

Error PB31 



( 



PBOO (Level ) : Unrecognized command . (Option 1 is not 

installed) . 

PB1 1 (Level 2): Port is busy , or port identifier is invalid 

(must be "P0:","P1:", or "P2: " ) . 

PB12 (Level 3): Parameter 1 memory error . (Out of memory 

while parsing the port name <str ing> . ) 

PB21 (Level 2): Invalid number of stop bits (must be 1 or 

-: 2). ■ - 

PB31 (Level 2 ) : Inv al id number of data bits ( must be 5? 6 , 

7, or 8) . 

References 

<Se t- stop- bit s> command . 



( 
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<Set-Prompt-String> Command 
SETUP Mode Name: PROMPTSTRING 
SYNTAX 

< set- prompt- st ring> = (ESC) (N) (S) 

<int-array : prompt-str ing> . 

PARAMETERS 

Prompt-String . An array of up to ten < int> parameters . 
Each <int> is the numeric equivalent of a single ASCII 
character , and so must be in the range from to 1 27 . 



Description 



Specifies the character sequence that is accepted as a 
prompt sequence when received from the host . The str ing can 
be up to 10 characters . 



De f aul ts 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 (63,32) Remembered Empty array 

- (?),(SP) 
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Errors 



NS11 (Level 2): Invalid < int-arr ay> parameter . (Must be an 

array holding from to 10 <int> parameters* 
Each of the items in the array must be an 
<int> in the range from to 1 27 • ) 

NS 12 (Level 3 ) : Parameter 1 memory error. (Out of memory 

while parsing the <int-array> . 

References 

<Pr ompt-mode> command . 
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<Set-Queue-Si ze> Command 

SETUP Mode Name: QUEUESIZE 



SYNTAX 

<set-queue-size> = (ESC) (N) (Q) 

<int+: queue-si ze > . 

PARAMETERS 

Queue-Size (1 to 65535). Number of memory bytes re- 
served for the commun ic at ions input queue . 



Description 

This command reserves part of the terminal 1 s memory as a 
storage area for the terminal ' s communications input queue 



If the queue si ze requested is larger than the available 
memory , then all available memory is allocated to the 
communications queue and a type NQ02 error is detected . 

Explanation . Sometimes characters come from the host 
computer at a rate faster than the terminal can process 
them . This can happen especially when those characters 
compr ise command s to perform lengthy and compl icated opera- 
tions : <include-copy-of-segment> , <save-segments : all>, 
etc . 



When characters arrive faster than the terminal can process 
them , the terminal stores them in its communications input 
queue un til it has a chance to process them - or until the 
memory allocated for that queue is exhausted . (If the queue 
memory is exhausted , incoming characters are lost . ) 

Spec if ying a 1 arge max imum queue si ze permits the terminal 
to buffer more characters before data is lost . Specifying a 
small commun ic ations queue si ze leaves more of the termi- 
nal 1 s memory avail able for other uses . 

Issuing a < set-queue- si ze : N> command causes the terminal 
to reserve at least N eight-bit bytes for its communications 
input queue . The actual queue size may be somewhat larger 
than N ; however , it will be at least N bytes large . 
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The terminal "remember s ff the queue size setting even when 
turned off. When the terminal is shipped from the factory , 
it maximum queue size is set to 300 bytes. 

NOTE 

The 4112 and 4113 can display simple 
alphanumeric^ and graphics up to a maxi- 
mum continuous data rate of 9600. 
bits/second* The 4114 can display simple 
alphanumeric^ and graphics up to a con- 
tinuous data rate of 19200 bits/second . 
(This does not include commands which 
require more than routine processing , 
such as the <include-copy-of-segment> or 
<load> commands,) At higher data rates ? 
some "handshaking" protocol must be used 
to prevent the terminal * s communications 
input queue from overflowing* 

Moreover , even at slow data rates , it is 
prudent to use a handshaking protocol . 
The terminal can take an appreciable 
amount of time to execute some commands 

- such as <load> or <save- segments : all> 

- which can be issued using only a very 
few characters. If a handshaking proto- 
col is not used , the terminal 1 s input 
queue may overflow while executng such 
commands. 

Such a handshaking protocol might be as 
simple as issuing a <report-401 0-status> 

command from time to time f and waiting 
to receive the reply before issuing more 
commands to the terminal . Alternatively f 
any of several data communications pro- 
tocols may be used : flagging mode, 
prompt mode, or block mode * Any of these 
communications modes will prevent the 
input queue from overflowing. 
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Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 300 Remembered Error NQ 1 1 

Errors 



NQ02 (Level 3): Out of memory while performing <set-queue- 

size> command . 

NQ11 (Level 2): Invalid queue size. (Must be in the range 

from 1 to 65535.) 

References 

<Se t- baud- rate s> command. 
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<Set-Report-EOM -Frequency^ Command 



SETUP Mode Name: REOM 



SYNTAX 

<set-repor t-eom- frequency^ = (ESC) (I ) (M) 

< in t : EOM-frequency> • 

PARAMETERS 

EOM-Fr equency (0 or 1), If this parameter is zero, 
<E0M-ind icator> s are sent "less frequently" in report 
messages . (That is , the terminal send s an <EOM-indica- 
tor> only when needed to prevent the maximum line 
length from being exceeded . ) If this parameter is one , 
<E0M-ind icator s> are sent "more frequently" - at the 
end of each part of the message . 



Description 

The command controls how frequently the terminal inter- 
sperses <E0M-ind icator > s among the characters that comprise 
a " report message" that the terminal send s to the host 
computer : <GIN-report-sequence> s , <dev ice- status- re port> s , 
<por t- status- re port>s , < segment- status- report> s , < terminal- 
set tings- re port> s , etc . 

Generally speaking , setting the report-EOM-fr equency to " 1 " 
( more frequent) causes a long message to be broken into 
separate 1 ines of text for each part of the report . For 
instance , each <GIN-repor t> within a <G IN- report- sequence> 
would occupy a separate 1 ine of text , terminated with an 
<EOM-indicator> . 
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Setting the report-EOM- frequency to "0" (less frequent) 
permits several parts of a report to fit on the same line of 
text. For instance, several <GIN-repor t> s could fit on the 
same line. The line is terminated with an <E0M-indicator> 
only when the terminal 1 s maximum line length is about to be 
ex ceed ed . 

<EOM-Indicator>s . The <E0M-ind icator> ( end-of-message indi- 
cator) serves to mark the end of a "line of text" in data 
being sent to the host . If the terminal is not in block 
mode , the <E0M-ind icator> is the current end-of-line str ing , 
as defined by the most recent < set-EOL-str ing> command . In 
block mode , the terminal send s an <E0M-ind icator> by termi- 
nating the block and setting the " end- of- message" bit in the 
<block-control-bytes>. 

Report Messages* " Report messages" are messages which the 
terminal send s in response to such command s as < enable-GIN> , 
<report-errors>, <repor t-dev ice- status> , and so on . Exactly 
where <E0M-ind icator> s occur within a report messages de- 
pends on the syntax for the par ticul ar type of report 
message : 

For GIN reports , see the descriptions of <GIN-report- 
sequence> , <GIN-locator-repor t> , <GIN-pick-report>, 
and <GIN-stroke-repor t> . 

For other reports ( "inquiry" reports) , see the de- 
scriptions of the <report-device-status> , <repor t-er- 
rors> , < report- port- st at us> , < report- segment- status> , 
and <report- terminal- setting s> command s . 
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Def aul ts 



Parameter 
Number 



As Shipped 
From Factory 



On Power-Up 



If the Parameter 
is Omitted 



Error s 



IM11 (Level 2): Inv alid ■' report- eom- frequency setting (must 

be or 1 ) . 



References 

<GIN-locator-report> 
<GIN-pic.k-report> 
<GIN-repor t-sequenee> 
<GIN-stroke-report> 
<Repor t-dev ice- status> 
CRepor t-por t- status> 
<Re po r t- segment- st at us > 
<Report- terminal -set ting s> 
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<Set«»Report-Max-Line-Length> Command 



SETUP Mode Name: RLINELENGTH 



SYNTAX 

<set-repor t- max- line- leng th> = (ESC) (I ) (L ) 

< int : max- line- leng th > . 

PARAMETERS 

Max-Line-Length (0 to 65535) . The maximum number of 
characters per 1 ine in reports which the terminal 
sends to the host . Setting thi s parameter to zero 
d isables the max im urn- line- leng th feature . 



Description 

The command sets the max imum line length for report messages 
which the terminal send s to the host computer . It al so 
determines how f r equently the terminal intersperses <E0M- 
indicator>s among data being transferred to the host in a 
<copy> , < spool> , <save> , <plot> , or <direc tor y> command . 

Specifying a max imum line length of zero d isables this 
feature ; in effect , the max imum line length is set to 
infinity . 

<EOM-Indicator>s . The terminal uses <EOM-indicator> s ( end- 
of-message ind icator s) to force the end of a 1 ine of text in 
data it sends to the host . If the terminal is not in block 
mode , it substitutes , for each <EOM-indicator> in the data , 
the current <E0L-str ing> , as determined by the most recent 
< set-EOL-str ing> command . In block mode , however , the termi- 
nal merely terminates the block and sets the end-of-message 
bit in the < block- control -byte s> . 
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Report Messages. If the terminal has a report to send to the 
host, and that report would cause the maximum line length to 
be exceeded , then the terminal inserts an <EOM-indicator> 
into the report . The <EOM-ind ic ator > serves to terminate the 
current line of text . 

The exact places where <EOM-indicator>s may be inserted are 
described in the syntax of the par ticul ar report type . For 
details , see the description of the ind iv idual report type : 

<dev ice- status- report> 
<GIN-report-sequence> 
<por t- status- report> 
<segment-status-repor t> 
<terminal-se t tings- re port> 
<char-repor t> 
<int-repor t> 
<xy-report> 

Other Data Sent To The Host . When the terminal sends data to 
the host in response to a < copy> , < spool> , < save) , <plot> , 
or <direc tory> command , it intersperses <E OM-indica to r>s in 
that data , so as to break the data into 11 lines of text." 
Each such 1 ine of text has the max imum line length , as 
determined by the < se t- re port- max -line- length> command . 

This feature is to accomodate host computers which cannot 
r el iably accept 1 ines of more than a certain number of 
characters . The feature can be d isabled by setting the 
terminal's max imum line length to zero. 
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NOTE 

Even if the data being transferred al- 
ready contains ( CR) characters ( or other 
<EOM-ehar>s) , the terminal still inserts 
a (CR) (or other <EOL-string> ) after 
every max- line- length characters of da- 
ta . 

Therefore , if you will be transferring 
data that is already broken into 
individual lines of text, you should set 
the terminal 1 s max- report- line- length to 
zero , thereby disabling the "maximum 
line length" feature, (Alternatively, 
you can set the <EOL-str ing> to the 
empty string . ) 



Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 

Errors 



IL11 (Level 2): Invalid max imum report 1 ine length . ( Must be 

in the range from to 65535.) 
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References 

<Char-repor t> 

<Copy> command 

<Dev ice-status-report> 

<Dir ec tor y> command 

<EOM~indicator> 

<G IN -re port- sequence> 

<In t-repor t> 

<Plot> command 

<Port-stat.u.s-rep : ort> 

<Save> command 

<Segment- status- repor t> 

<Spool> command 

<Te rm in al- settings- repor t> 

<XY-report> 



4-494 



REV, DEC 1981 4110 SERIES COMMAND REFERENCE 



ALPHABETICAL LISTING 



<Set-Report-Sig-Chars> Command 



SYNTAX 

<set-report-sig-chars> = (ESC) (DCS) 

<int : report- type- cod e > 

< in t : sig-char> 

<int : term-sig-char > . 

PARAMETERS 

Report-Type-Code (-3 to -1, or a valid GIN device- 
function code). If this is a GIN device-function code, 
then the signatures characters defined in this command 
will be used in <GIN-repor t- sequence> s for that de- 
vice-function code . If this parameter is -3 , then 
these signature characters are used in non-GIN report 
messages. If the parameter is -2, these signature 
characters are used only when responding to <repor t- 
GIN-point : -2> commands . If the parameter is minus 
one , then these signature characters are used in all 
report messages ( bot GIN reports and non-GIN reports) . 



Description 

This command assigns the "signature characters" to be used 
within report messages which the terminal sends to the host 
computer . 

Report Type Code. The first parameter specifies in which 
type of report these signature characters will be used . 

Zero or a positive number represents a GIN dev ice- f unction 
code ; see the description of the <enable-GIN> command for 
details . Future <GIN-report-sequence> s for that dev ice- func- 
tion combination will use the signature characters specified 
in this <set-repor t- sig-char s> command . 
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"Minus three" specifies " inquiry reports" - report messages 
sent in response to non-GIN commands, such as Report- 
term in a 1- set ting s> , <repor t-error s> , <report-port-status> , 
etc. 

"Minus two " spec if ies responses to <report-GIN- point : -2> 
commands only . 

"Minus one" specifies " all reports" - inquiry reports and 
reports for all GIN device- function combinations . 

<Sig-Char> . The second < in t> parameter is the numeric equiv- 
alent of the ASCII character which is to be used as the 
<sig-char> in reports of the specified type . If the < sig- 
char> is set to (NUL ) - numeric equivalent of zero - then 
that <sig-char> is omitted from reports sent to the host. 

<Term-Sig-Char> . The third <int> parameter specifies the 
character to to be used as the < term- sig- char> in reports of 
the specified type . If the < term-sig-char> is (NUL), then it 
is omitted in reports sent to the host . 

NOTE 

If GIN is enabled for more than one 
device at a time, then different <sig- 
char>s and < term- sig- char >s are required 
for each enabled GIN device. This is 
necessary in order that the host compu- 
ter can parse the interleaved <GIN-re- 
port-sequence>s which can be sent to the 
host if more than one GIN device is 
active. 

Al so , if non-GIN reports are requested 
while GIN is enabled , then different 
<sig-char>s and < term- sig- char >s are 
needed to distinguish non-GIN reports 
from GIN reports. 

On power up , all signature characters are initial ized to 
(NUL). 
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Defaults 



Parameter 
Number 



As Shipped 
From Factory 



On Power-Up 



If the Par ameter 

is Omitted 



None 



None 







2 















3 















Errors 



1011 (Level 2): Invalid report type code. (Must be a valid 

dev ice- function code, or in the range from - 
1 to -3.) 

IS21 (Level 2): Invalid second parameter, (Must be in the 

range from to 1 2? ) . 

IS3 1 (Level 2): Invalid third parameter. (Must be in the 

range from to 1 27. ) 

Re f erences 

<GIN-locator-report> syntactic constr uc t . 
<GIN-pick-repor t> syntactic construct. 
<G IN -report- sequence> syntactic construe t . 
<GI N- stroke- report> syntactic construe t . 
<Report-dev ice- stat us> command . 
<Repor t-er ror s> command . 
<Report-por t-status> command . 
<Report- segment- stat us> command . 
<Report- term in al- set ting s> command . 
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<Set-3egment>Clas8> Command 



SYNTAX 

<set-segment-class> = (ESC) (S ) ( A) 

<int : segment- n urn ber > 

< in t- array : removal-array> 

<int-array : addition-arr ay > . 

PARAMETERS 

Segment-Number (-3 to -1, or 1 to 32767 ) . Names the 

segment which is being removed from , or added to , one 
or more segment classes . 

Removal-Array. Li sts the segment classes from which 
the spec if ied segment is being removed . Class numbers 
are in the range from 1 to 64 . The special class 
number, minus one, means " all segment classes." 

Addition-Array . Lists the segment classes to which the 
specified segment is being added . 



Description 

The < set- segment- cl a ss> command adds a segment to , or de- 
letes a segment from , one or more segment classes* 

The segment number may be -3, -2, -1, or any positive 
segment number for an existing segment. "Segment -3 " means 
" all segments in the current segment matching class." "Seg- 
ment -2 " means "def aul t for new segments not yet defined." 
"Segment - 1 " means " all currently ex isting segments . " 

Class numbers may be - 1 (meaning " all classes" ) , or any 
number in the range from 1 to 64. 
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The segment (or segments) is removed from (made a non-member 
of) all the segment classes listed in the first < int-arr ay> 
parameter. Once this has been done , the segment is then 
added to (made a member of) all the classes listed in the 
second < int-arr ay> parameter . If a class number is listed in 
both the < int-arr ay> parameters, the segment will be a 
member of that class upon completion of the command. 

In the < int-arr ay> parameters , class number - 1 may be used 
to represent "all segment classes . " 

It is not an error to delete a segment from a class to which 
it does not belong ; nor is it an 'error to add a segment to a 
class to which it already belongs . 
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Def aul ts 



Parameter 
Number 

1 

2 

3 

Errors 



As Shipped 

From Factory 

None 

Empty array 

Empty array 



On Power-Up 
None 

Empty array 
Empty array 



If the Parameter 
is Omitted 



Empty array 
Empty array 



SA03 (Level 2): Command inval id at this time : the specified 

segment is currently being defined . 

SA 1 (Level 2 ) : Segment does not ex ist . 

SA 1 1 (Level 2): Invalid segment number . ( Must be in the 

range from -3 to -1 , or from 1 to 32767 . ) 

SA21 (Level 2): Invalid "removal" class number array . (Each 

class number must -1 or in the range from 1 

to 64. ) 

SA22 (Level 3 ) : Parameter 2 memory error . (Out of memory 

while parsing the "removal" <int-array> par- 
ameter . ) 



SA31 (Level 2) 



SA32 (Level 3) 



Re ferences 



Inval id " include" class number array . (Same 
rules as for the "removal" class number 
array . ) 

Parameter 3 memory error. (Out of memory 
while parsing the "addition" < int-arr ay> 
parameter . ) 



<Se t- cur rent- matching- cl a ss> command 
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<Set-Segment-Detectability> Command 



SYNTAX 

<set-segment-detectability> = (ESC) (S ) (D ) 

< in t : segment-number> 
< in t : detectabil ity > . 

PARAMETERS 

Segment-Number (-3 to 1 , or 1 to 32767) . Names the 
segment whose detec tab il ity mode is being set . 

Detectabil ity (0 or 1). Zero prevents the segment from 
being picked in a graphic input "pick" operation. One 
allows the segment to be picked . 



Description 

If a detectabil ity of 1 is spec if ied , and the segment is 
visible , it may be picked when the pick function is enabled . 
If is specified , the segment may not be picked . 

"Segment Number" Parameter . The segment number may be a 
positive number , or any of the special negative numbers -1, 
-2, and -3- A positive number refers to a specific single 
segment , pr ev iously defined with <begin-segment> and <end- 
segment> command s . "Segment -1" means ff all segments . 11 "Seg- 
ment -2" means "default for segments not yet defined . " 
Segment -3 means " all segments in the current segment 
matching class." 

NOTE 

If a graphic input operation is in prog- 
ress , and the segment specified in this 
command is being used as the graphic 
cur sor , then this command has no ef feet • 

The def aul t segment detectabil ity is zero (non-detectable) . 
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( 



Def aul ts 

Parameter 
Number 

1 

2 

Errors 



As Shipped 
From Factory 

None 





On Power-Up 

None 




If the Parameter 
is Omitted 

Error SD11 





SD03 (Level 2 ) : Command is invalid at this time . (The spec i- 

fied segment is currently being defined . ) 

SD10 (Level 2) : Segment does not ex ist . 

SD11 (Level 2): Inv al id segment number ( must be in the range 

-3 to -1, or 1 to 32767)". 

SD21 (Level 2): Invalid 11 detectability mode" ( must be or 

1 ) . 

References 

<Enable-GIN> command . 

<Se t- cur rent- matching- cl a ss> command . 

<Set-segment-class> command. 
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<Set-Segment-Di spl ay-Prior it y> Command 



SYNTAX 

< set- segment- displ ay-priority> 

= (ESC) (S)(S) 

<int : segment- n urn ber> 
< in t : pr ior it y-n umber > . 

PARAMETERS 

Segment-Number (-33 ot -1, or 1 to 32767) . Names the 
segment for which a d ispl ay pr ior ity is being set . 

Priority-Number (-32768 to +32767). 



Description 

Sets the display pr ior ity of the specified segment . (The 

d ispl ay pr ior ity number may be any integer in the range from 

-32768 to +32767.) 

NOTE 

During a graphic input pick operation , 
the display priority of segments affects 
which of several "eligible" segments 
will be picked . (An 11 eligible" segment 
is a visible , detectable segment , part 
of which falls within the current pick 
aperture*) Of eligible segments , the one 
with the highest priority is the one 
that will be picked . 

On power-up , the defaul t pr ior ity for new segments is zero . 
(This may be changed , however , by issuing a < set- segment- 
displ ay-pr ior ity> command for "segment -2 . " ) 
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On a 4112 or 4113, upon red ispl ay ( that is, when an 
invisible segment is m&de visible, or when a view is 
renewed) , the segments are displayed in priority order , 
that the segment(s) last displayed are those with the 
highest display priority. 



so 



On a 4114, upon redisplay, the segments are displayed in 
reverse pr ior ity order . That is , the segments first dis- 
played are those with the highest pr ior ity . 

For segments which are assigned the same display priority 
number, the order of display and the order of picking are 
not defined , and may be different on different TEKTRONIX 
terminal s . 



Defaults 



Parameter 
Number 



As Shipped 
From Factory 



On Power-Up 



If the Parameter 
is Omitted 



1 

2 

Errors 



None 





None 





Error SS1 1 





SS03 (Level 2 ) : Command is inval id at this time . (The speci- 
fied segment is currently being defined . ) 

5510 (Level 2): Segment does not exist. 

5511 (Level 2): Invalid segment number (must be in the range 

from -3 to -1, or from 1 to 32767). 

SS21 (Level 2): Invalid priority number (must be in range - 

32768 to +32767 )'".' 

References 



<Enable-GIN> command . 
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<Set-Segment-Highlighting> Command 



SYNTAX 

<set-segment-highlighting> = (ESC)(S)(H) 

<int : segment- number > 
<int : highl ighting > . 

PARAMETERS 

Segment-Number (-3 to -1, or 1 to 32767). Names the 
segment for which a highlighting mode is being speci- 
fied . 

Highlighting (0 or 1). One causes the segment to 
"blink" (alternate between being visible and being 
invisible) . Zero turns off the "blink" feature . 



Description 

Highlighting a graphics object turns the illuminated pixels 
off and on, making the graphic object blink. 

On a 4114, if a highlight of 1 is specified, the specified 
segment is blinked on and off at a slow rate. If is 
specified, the blinking stops. 

On a 4112 or 4113, if a highlight mode of 1 is specified, 
the segment is blinked on and off at a slow rate . This is 
done in the following way. All the bits of all the pixels in 
the segment are complemented ; zeroes become ones , and ones 
become zeroes . Then , after this has been done for all the 
segments which are being highl ighted , the process is 
repeated , so the the segments being highl ighted appear as 
they d id before . 

On the 4112 or 4113, segment highl ighting is performed 
regardless of the current f ixup level . 



4110 SERIES COMMAND REFERENCE REV.DEC1981 



4-505 



ALPHABETICAL LISTING 



( 



NOTE 



If there are many segments, or complex 
segments with many pixels, the high- 
lighting process in the 4112 may be very 
slow. In that case, you may find it 
advantageous not to use the <set- seg- 
ment- highlight ing> command, Instead, you 
can place the segments to be highlighted 
in a different view with a viewport on 
another surface, and "blink" that sur- 
face with the <set-surface-visibility : 
2> command « 



Setting the second parameter in the <set-segment- 
highl ighting> command to zero turns off the highl ighting 
feature for the specified segment . The default is no high- 
lighting • 



Def aul ts 

Parameter As Shipped On Power-Up If the Paramet 



Number 



From Factory 




None 



None 







2 















( ■ 
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Errors 

SH03 (Level 2): Command is invalid at this time. (The speci- 
fied segment is currently being defined.) 

SH10 (Level 2): Segment does not exist. 

SH1 1 (Level 2): Inval id segment number ( must be in the range 

from -3 to -1 , or from 1 to 32767) . 

SH21 (Level 2): Invalid highl ighting mode ( must be or 1 ) . 

Re f erences 

<Se t- f ixup- level > command . 
<Set-surface-visibility> command . 
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<Set-Segraent-Image-Tr ansform> Command 



SYNTAX 

<set- segment- image- tr ansform> 

= (ESC) (S.)(I ) 

<int : segment-number> 
<real : x-scale-factor> 
<real : y -scale- facto r > 
<real : rotat ion-angle> 
<xy : position > . 

PARAMETERS 

Segment-Number (-3 to -1, or 1 to 32767). Names the 
segment for which an image transform is being spec i- 
f ied • 

X -Scale-Factor (-32767.0 to +32767.0) . The factor by 
which the segment is scaled in the x-direc tion . 

Y-Scale-Factor (-32767.0 to +32767.0) • The factor by 
which the segment is scaled in the y-direc tion . 

Rotation-Angle (-32767.0 to +32767.0). The 

coun terclockwi se rotation angle , in degrees . ( A nega- 
tive number specifies a clockwi se rotation . ) 

Position (X = to 4095, Y = to 4095). The position 
in terminal space where the segment' s pivot po int is 
to be located . 



Description 

The < set- segment- image- t ran sform> command transforms the 
segment as follows : 

1 . First , the segment is scaled in the x- and y- 

direc tions by the amounts specified by the x and y 
scale factors. A negative scale factor ind icates an 
inversion about the appr opr iate axis. 
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2. Next, the segment is rotated counterclockwise about 

its pivot point by the number of degrees specified in 
the "rotation" parameter. If this parameter is nega- 
tive, then the segment is rotated clockwise, 

3. 

Finally, the segment is moved (translated) so that its 
pivot point is at the position specified by the 
"position" <xy> parameter . 

Image transform operations are not cumulative. They always 
start at the size and position of the segment as originally 
defined . 

In the 4114, if a segment is visible , the operator can 
immediately see the effect of a < set- segment- image- trans- 
form^ command . In the 4112 and 4113, however , the current 
f ixup level determines how soon the d ispl ay is upd ated to 
show the new po sition of the transformed segment • (See < set- 
f ixup-level> for details . ) If the f ixup level is less than 
two , then the effect of the new image transform cannot be 
seen un til the next <page> or <renew> command , or the nex t 
depression of the PAGE, VIEW, OVERVIEW, or RESTORE keys. 

Segment Number . A segment number in the range from 1 to 
32767 specifies one par ticul ar segment . "Segment -1 " means 
" all segments currently defined ," while " segment -3" means 
" all segments of the current segment matching class . " (The 
current matching class is determined by the most recent 
< set-cur rent-matching-class> command . ) 

Specif ying segment number zero is not allowed . ( "Segment 
zero" refers to the crosshair cur sor , which cannot be 
rotated or scaled . If you want to change the position of 
segment zero , use the < set- segment- po si tion> command . ) 

"Segment number -2" means "default for segments not yet 
defined . " You c an set the image transform parameters for 
segments which have not yet been defined . However , if the x- 
and y-scale factors are not unity , if the rotation angle is 
not zero , or if the position parameter is not the same as 
the current pivot point , then a segment being defined will 
not be d ispl ayed until an <end-se.gment> command terminates 
the segment definition . 
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4114 Clipping* After the scaling, rotation, and positioning 
has occurred , parts of the segment whose x- or y-coord inates 
are outside the range from to 4095 are !l clipped" (made 
inv isible) . 

On a 4112 or 4113, after the scaling, rotation, and posi- 
tioning has occurred, any parts of the segment which extend 
outside the current window will not be displayed. 



NOTE 



Do not use <set-segment-image-transform> 
(or <set-segment-position> ) to position 
a segment so that part of it extends to 
X or Y coordinates greater than 8091? or 
to X or Y coordinates less than -4096 . 
Segments extending that far outside the 
normal 0-to-4095 terminal space may not 
be displayed properly. 

If a segment is being used as the graphic cur sor for a GIN 
operation , moving that segment with the < set- segment- image- 
tr ansf orm> command does not change the current graphic input 
location . The next time the operator moves the thumbwheel s 
( or other GIN device) , the graphic input location is changed 
and the segment 1 s pivot point is moved to that new graphic 
input location . 

If a segment's position is changed by the <set-segrnent- 
position> command , or by using the segment as a graphic 
input cur sor , then the current image transform for that 
segment is updated to ref 1 ec t the change . 
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Defaults 



Parameter 
Number 

1 

2 

3 
4 
5 



As Shipped 
From Factory 

None 

1.0 

1 . 
0.0 
(0,0) 



On Power-Up 

None 
1.0 
1 . 
0.0 

(0,0) 



If the Parameter 
is Omitted 

Error S1 1 1 

0.0 

0.0 

0.0 

(0,0) 



Errors 



SI03 (Level 2) 

SI02 (Level 3) 

5110 (Level 2) 

51 1 1 (Level 2) 

SI21 (Level 2) 

SI31 (Level 2) 

SI41 (Level 2) 



Command is invalid at this time. (The 
specified segment is currently being de- 
fined.) 

Out of memory while transforming segment . 
Segment does not exist. 

Invalid segment number (must be in the range 
-3 to -1 , or 1 to 32767) . 

Invalid X-scaling factor. (Must be in the 
range from -32767.0 to +32767.0) 

Invalid Y-scaling factor. (Must be in the 
range from -32767.0 to +32767.0) 

Invalid rotation angle. (Must be in the 
range from -32767.0 to +32767.0) 



References 

<Begin-segment> command. 
<Se t- pivot- po in t> command. 
<Set-segment-position> command 
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<Set-Segment-Position> Command 



S PTAX 

"'"^ <Set-sfegment-position> = (ESC) (S ) (X ) 

< in t : segment-nurnber> 
<int: position> . 

PARAMETERS 

Segm|rit~Number (-3 to +32767 ) . Names the segment whose 
position is being specified . 

Position (X = to 4095, Y = to 4095). The position 
in terminal space where the segment f s pivot po in t is 
to be located . 



De script ion 

The segment specified by the < int> parameter is moved so 
that its pivot point is at the location specified by the 

< xy>. par ameter . 

A segment number in the range from 1 to 32767 specifies a 
segment which has pr evviously been defined with <begin- 
segment> , and <$n<j-s.egme.nt> commands. An error is detected if 
the specified segment does not exist. 

"Segment zero" refers to the crosshair graphic cur so r . 
"Segment - 1 " means all currently defined segments ( with 
numbers from 1 to 32767 ) . "Segment -3" means all segments in 
the current segment matching class . 

"Segment -2" means "the default for segments not yet de- 
fined ." Normally , when a segment is defined , its position is 
set to the same location as its pivot point ( set by the most 
recent < set- pivot- po in t> command) . However , you can issue a 
< set- segment- posit ion : -2 , ( x , y ) > command in which ( x , y) is 
a different location from the current pivot point. If you do 
this on a 4114, however, a segment being created is not 
d ispl ayed until after the <end-segment> command that termi- 
nates the segment definition . 
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Issuing a <set-pivot-point> command cancels the effect of 
any previous < set- segment- posit ion> commands for segment -2. 

On a 4114, if part of the segment goes off the right or left 
edge of the screen (X > 4095 or X < 0), that part of the 
segment will not be displayed. However, you should avoid 
positioning a segment so that any part of it extends far off 
the screen ( X > 8191, X < -4096, Y > 8191, or Y < -4096). 
If you do, the part of the segment which extends that far 
off the screen will "wrap-around" and come back into view - 
on the opposite side of the screen. 

If a segment has not been rotated or scaled (with the < set- 
segment- image- t ran sform> command), then segment vectors that 
go higher than Y=3071 , or lower than Y=0, stop being visible 
only when the edge of the display is incountered. The exact 
Y coord inates ( outside the normal to 3071 range) where the 
vectors become invisible will vary during terminal usage; 
therefore, host programs should not rely on knowing these 
exact values. 

If a segment has been positioned with the <set-segment- 
im ag e- tr an s f o rm> command ( rather than only with the <set- 
segment-posi tion> command) , then a different rule appl ies . 
The < set- segment- image- 1 ran sform> command suppresses any 
vectors which extend below the 1 ine Y=0. 

On a 4112 or 4113, if part of a segment extends outside the 
current window, then that part of the segment is not 
d ispl ayed . 

A segment f s position may also be changed by the < set- 
segment- image-tr ansform> command , or by using the segment as 
the graphic input cursor. 

If the segment specified is being used as the graphic cur so r 
in a GIN operation , then the segment's position is changed 
by the < set- segment- po si tion> command , but the current 
graphic input location is not upd ated . The graphic input 
location will be updated , and the segment serving as the 
graphic cur so r will be moved , the next time the operator 
moves the thumbwheels ( or other graphic input dev ice) . 
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( 



Def aul ts 



Parameter 
Number 



As Shipped 
From Factory 



On Power-Up 



If the Parameter 
is Omitted 



None 



None 







2 



(0,0) 



(0,0) 



(0,0) 



Errors 



SX02 (Level 3 ) : Out of memory . 

SX03 (Level 2): Command is invalid at this time : the 

specified segment is currently being de- 
fined . 

SX10 (Level 2 ) : Segment does not exist . 

SX1 1 (Level 2 ) : Invalid segment number ( must be in the range 

from -3 to +32767. ) 

Re fer ences 

<Set-current-matching-class> command . 
<Set-pivot~point> command . 
<Se t- image- t ran sform> command . 
<Set-window> command . 



( 
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<Set-Segment-Vi sibil it y> Command 



SYNTAX 

<set-segment-visibility> = (ESC)(S)(V) 

<int : segment- number > 
<in t : v isibil ity> . 

PARAMETERS 

Segment-Number (-3 to +32767). Names the segment whose 
visibility is being specified. 

Visibility (0 or 1 ) . Zero means "invisible," while one 
means "visible . " 



Description 

4112 or 4113. On a 4112 or 4113, the visibility attribute of 
the specified segment ( or segments) is set to "visible" or 
" inv isible • " If a visibil ity of 1 is specified for a segment 
in the current view, the segment appears in the mode 
spec if ied by the most recent < set-segment-wr iting-mode> com- 
mand for that segment . 

If a visibility of is specified , the segment is made 
inv isible , either immediately or the next time the screen is 
erased , depending on the f ixup level specified in the most 
recent < set- f ixup-level> command . 

In the 4112 and 4113, segments are only automatically 
visible in the view in which they are created . That is , 
segment visibil ity is " local" to the view. However , segments 
themselves are "global" to all views . That is , they ex ist in 
all v iews , but must be made v isible explicitly in any view 
other than the one in which they are created . 
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Here, "the view in which a segment is created" means "the 
view which was selected at the time of the <end-segrnent> 
command which terminated the segment definition." 

4114. On a 4114, the visibility attribute of the specified 
segment is set to "visible" or " inv isible" . If a visibil ity 
of 1 is specified , the segment appears immed iately . 

If a visibility of is spec if ied , the segment is removed 
immediately from the display if it was d ispl ayed in refresh 
mode ; otherwi se it is removed the next time the d ispl ay area 
is erased . 

Default Visibility. In all terminals (4112, 4113, 4114), the 
default for new segments is visible . Thi s may , however , be 
altered by a < set- segment- visibil ity> command for " segment - 
2." 

Segment Number . A segment number in the range from 1 to 
32767 appl ies to one par ticul ar segment . (If that segment is 
not present , then the terminal detects an error , ) "Segment 
0" means the graphic crosshair cur sor . Segment numbers - 1 , - 
2 , and -3 refer , respectively , to " all segments , " "all 
segments not yet defined , " and " all segments in the current 
segment matching class . " 

NOTE 

When GIN is enabled , the terminal saves 
the visibil ity attribute for the segment 
which is to be used as the graphic 
cursor . That segment is then made visi- 
ble . When GIN is disabled, the saved 
value of the visibility attribute is 
restored to the segment which acted as 
the graphic cursor . 

Therefore , any <set-segment- visibil it y> 
commands , which may be issued for the 
graphic cursor while GIN is enabled , 
will cease to have effect when GIN is 
disabled . 
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Defaults 



Parameter 

Number 

1 

2 

Errors 



As Shipped 
From Factory 

None 

1 



On Power-Up 

None 
1 



If the Parameter 

is Omitted 






SV02 (Level 3): Out of memory. 

SV03 (Level 2): Command is invalid at this time. (The 

specified segment is currently being de- 
fined.) 

SV10 (Level 2): Segment does not exist. 

SV11 (Level 2): Invalid segment number (must be in the range 

from -3 to +32767) . 

SV21 (Level 2): Invalid visibility mode (must be or 1 ) . 

References 



None , 
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<Set-Segment-Wr iting-Mode> Command 



SYNTAX 

<set- segment-wr iting -mod e> = (ESC) (S ) (M) 

< in t : segment- n urn ber> 

y< int : wr iting-mode> . 
PARAMETERS 

Segment-Number (-3 to +32767 )• Names the segment for 
which a writing mode is being spec if ied . 

Writing-Mode (0 or 1). In the 4114, mode is "storage 
mode;" when a segment is displayed, it is stored in 
the phosphor of the terminal 1 s d irec t- view storage 
tube. In the 4112 and 4113, mode is "set mode; " 
displaying a segment sets pixels in raster memory 
space to exactly those color- indices used in the 
segment definition. 

In the 4114, mode 1 is " refresh mode ; " a segment is 
not stored in the tube' s phospher , but instead is 
refreshed continually by re- traversing all the lines 
of the segment . If the terminal is equi pped with 
Option 3 1 , the segment appear s orange rather than 
green . In the 4112 and 4113, mode 1 is "XOR mode; " 
displ aying a segment causes a bit-by-bit XOR operation 
to be performed on pixels at which the segment is 
d ispl ayed . 



Description ( for the 4112 and 4113 Terminals) 

This command specifies the wr iting mode that is used when 
d isplaying the specified segment . More pr ec isely , it deter- 
mines the wr iting mode used when wr iting an image of the 
segment into a viewport on a wr iting sur face in raster 
memory space . 

Valid segment numbers are - 1 ( "all segments" ) , -2 ( "def aul t 
for segments not yet defined" ) , -3 ( "all segments in the 
current segment matching class" ) , and par ticul ar segment 
numbers in the range from 1 to 32767 . Errors are detected if 
segment zero is specified , or if a segment number for a 
nonex istent segment is specified . Specifying segment zero 
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(the crosshair cursor) is not an error, but does not result 
in any action . 

If the segment number is -2 ("default for new segments" ) , 
this command also sets the wr iting mode for the following : 

Alphatex t sent to the graphic area . (That is alphatex t 
sent to the terminal when the d ialog area is disabled . 

Gr aphtex t . 

Lines ( vectors) , markers , and panels . 

Mode 1 (Set Mode) . As an image of the segment is wr itten 
into the current v iewpor t , each pix el being wr itten over is 
set to the appropr iate color- index . The color- index is the 
current 1 ine index for pixels which form the image of 1 ines 
or graphtex t , and the current text index for pixels which 
make up characters of alphatex t or graphtex t . The pr ev ious 
color- index stored in the pix el is destroyed . 

Mode 2 (XOR Mode) • As an image of the segment is written 
into the current viewport , each pixel being wr itten over is 
r epl aced by a pixel in a new color- index . The new color- 
index is a binary number which is the bit-by-bit " exclusive 
OR" of the bits in the old color- index for that pixel and 
the correspond ing bits of the current line index or text 
index . 

Thi s XOR ( exclusive OR ) mode is convenient for wr iting 
images which may later need to be erased or re-positioned on 
the screen . Thi s is because a 1 ine ( or alphatex t character , 
etc.) can be erased by wr iting over it again in XOR mode . 
(This property is a consequence of the Boolean log ic theorem 
that (A XOR B) XOR B = A.) 
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If the segment specified is currently being used as a 

graphic cur so r , then the < set- segment-wr i ting -mod e> command 

does not take effect un til the current GIN ( graphic input ) 
operation is disabled. 



NOTE 

In the 41 12 and 4113 terminals, it is 
prudent , after changing a segment 1 s 
writing mode , to issue a <page> or <re- 
new-view> command . This ensures that the 
viewport is updated to display the seg- 
ment properly. 

If you fail to do this , and the current 
f ixup level is five or more , it is 
possible that repositioning a segment 
may cause it to appear in more than one 
location on the screen . The remedy is 
for the host to issue a <page> or <re- 
new-view> command , or for the operator 
to press the PAGE key . 



Description ( for the 4114 Terminal ) 



This command determines whether a segment is to be displayed 
in storage or refresh mode . 

Valid segment numbers are - 1 ( "all segments"") , -2 ( "default 
for segments not yet defined" ) , -3 ( "all segments in the 
current segment matching class" ) , and par ticul ar segment 
numbers in the range from 1 to 32767 . Errors are detected if 
segment zero is specified , or if a segment number for a 
nonex istent segment is specified . 

Mode 1 (Storage Mode) . The segment will be displayed in 
storage mode . If currently visible and being displayed in 
refresh mode , the refresh image disappears and the segment 
is re-drawn in storage mode . 
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Mode 2 (Refresh Mode) . The segment will be displayed in 
refresh mode. If the segment is already visible in storage 
mode, the refresh image will appear superimposed upon the 
storage mode image; later, after the screen is erased, the 
only the segment's refresh-mode image will be visible. 
On power-up, the default display mode for all segments is 
mode 1 (storage mode). 

If the segment specified is currently being used as a 
graphic cursor, then the <set-segment-wr i ting -mod e> command 
does not take effect until the current GIN ( graphic input ) 
operation is d isabled . 



Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 None None 

2 1 1 Error SM21 



Errors 



SM03 (Level 2): Command is i n v a lid at this time . (The 

specified segment is currently being de- 
fined . 

SM 1 (Level 2): Segment does not ex ist . 

SM 1 1 (Level 2): Inval id segment number ( must be in the range 

from -3 to +32767 ) . 

SM21 (Level 2): Invalid wr iting mode ( must be or 1). 



References 

<Begin-pixel-operations> command . 
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<Set-Snoopy-Mode> Command 



SETUP Mode Name: SNOOPY 



SYNTAX 

<set-snoopy-mode> = (ESC) (K) (S) 

< in t : snoopy-mod e> . 

PARAMETERS 

Snoopy-Mode (0 or 1 ) . = NO; in SETUP mode, a SNOOPY 
NO command removes the terminal from snoopy mode . (The 
terminal cannot be removed from snoopy mode with the 
escape-sequence version of this command , because es- 
cape-sequence commands are ignored in snoopy mode . ) 1 
= YES ; puts the terminal in snoopy mode . 



Description 

A <se t- snoopy-mode : 1 > command puts the terminal in " snoopy" 
mode . Thi s lets the operator view control characters re- 
ceived from the host (or typed on the keyboard in LOCAL 
mode) 

Control characters such as (ESC) , (GS ) , ( US ) , etc . , are 
processed like any other printing ASCII character . (Each 
control char ac ter has a correspond ing " snoopy mode mnemonic" 
char ac ter which is d ispl ayed on the screen . ) The ( CR ) 
character , however , is not only displayed , but al so 
ad vancees the cur so r to the start of the next line. 

It is impossible to execute command s from the host or the 
keyboard ( except in SETUP mode) while snoopy mode is in 

effect. 



4-522 



REV, DEC 1981 4110 SERIES COMMAND REFERENCE 



ALPHABETICAL LISTING 



Only the operator can remove the terminal from snoopy mode . 
The operator can do this in two ways: 

The operator can press the CANCEL key; among other 
effects, this key removes the terminal from snoopy 
mode. (See the descriptions of the CANCEL key and the 
<cancel> command for details . ) 

The operator can press the SETUP key to put the 
terminal in setup mode . Then , while in setup mode , the 
operator would type the SNOOPY NO command . 



Typing SNOOPY NO in SETUP mode not only removes the terminal 
from snoopy mode , but al so puts the terminal in alpha mode . 



Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

10 1 

Errors 



KS 1 1 (Level 2): Invalid parameter ( must be or 1 ) 

References 

<Cancel> command . 
CANCEL key. 
SETUP key. 



4110 SERIES COMMAND REFERENCE REV,DEC1981 



4-523 



ALPHABETICAL LISTING 



<Set-Stop-Bits> Command 



SETUP Mode Name: STOPBITS 



SYNTAX 

<set*-stop-bits> = (ESC)(N)(B) 

< in t : number- of- stop- bit s > . 

PARAMETERS 

Number-Of -St op-Bits (1 or 2). 



De script ion 

Specifies the number of stop bits appended to each character 
transmitted from the terminal . 



Defaults 

Parameter 

Number 

1 



As Shipped 
From Factory 

1 



On Power-Up 



Remembered 



If the Parameter 
is Omitted 

Error NB11 



Errors 



NB 1 1 (Level 2): Inval id number of stop bits ( must be 1 or 

2). 

Re f erences 



None . 
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SETUP Mode Name: CMAP 



SYNTAX 

< set- surf ace-color-map> 

r (ESC)(T)(G) 

<int : sur face-number> 
<int-array ; color-mix tures> . 

<int-array : color-mix tures > = <int+ : count> 

[<quadruple> . . . ] . 

<quadruple> = <int : color-index> 

<int : f irst-color-coordinate> 
<int : second-coTor-Qoordinare > 
<int : third-color^coordinat"e>" • 

PARAMETERS 

Surface-Number («1 f or 1 to 4). Names the surface for 

which color mixtures are being defined . Minus one 
means a "super sur face" consisting of all bit planes 
of all surfaces presently defined . 

Color-Mixtures Array. An array of <int> parameters , 
which are considered in groups of four ( quadruples) . 
The first <int> in each quadruple names a color-index , 
while the following three <int>s specify the color 
mixture for that color-index . The color mixture is 
specified in the HLS, RGB , or CMY color coordinate 
system , according to the most recent <set-color-m^ue> 
command . 

If the first <int> in a quadruple is zero , then the 
following three <int>s specify the color of the back- 
ground which is behind all the writing surfaces. 
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4112,4113 
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In the HLS system of color coordinates, the hue 
coordinate can range from -32768 to 4-32767, while the 
valid range for the lightness and saturation coordi- 
nates is from to 100. In the RGB and CMY systems , 
all three coordinates range from to 1 00. 



Description 

The <set-sur f ace-color-map> command sets the "color map" for 
a particular surface. That is, it determines the mapping 
from that surface's color-indices to particular color mix- 
tures . 

This command also sets the surface gray levels to NTSC gray 
levels equivalent to the colors set using the following 
function : 

Gray level = .30*(Red level) ♦ .59*(Green level) + . 1 1*(Blue level) 

The resulting gray level value is always rounded to the 
nearest integer . 

On a 4112, any colors set with this command are displayed as 
gray levels that have been transformed with the above 
function . 

This command can be used to set the background color and 
background gray levels by setting the color of index zero. 

The effect of the <set-sur f ace-color-map> command continues 
until superseded by another <set-sur f ace-color-map> or <set- 
sur f ace-gray-lev el s> command , until sur faces are redefined 
with a <set-sur f ace-def initions> command , or until the 
terminal is reset (by the <reset> command or by pressing the 
RESET button) or turned off. 

In this command , "surface -1 " means a "super-surface" con- 
sisting of all bit planes in all surfaces presently J '-fined . 
This is for use in advanced applications, such as control- 
ling the exact color displayed where images on one surface 
overlap images on another sur face . If you plan to use this 
"super-surface" feature , be sure to read Appendix D, which 
explains the super-surface and its side effects . 
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Defaults 

The default colors for the 4112 are equivalent to the 
default gray levels , with Hue and Saturation always zero , 
and Lightness equal to the gray level . 

The <set«*sur f ace-def initions> command sets the color mixture 
for each index on each sur face to default values. The 
default colors are as follows : 



Color-Index Color Mixture 



Color Coordinates 







H 


L 


c 

a 


Standard 4113: 













Transparent 








1 


WHITE 





100 





2 


RED 


120 


50 


100 


3 


GREEN 


240 


50 


100 


4 


BLUE 





50 


100 


5 


CYAN 


300 


50 


100 


6 


MAGENTA 


60 


50 


100 


7 


YELLOW 


180 


50 


100 


4113 with Option 


21: 








8 


RED-YELLOW (ORANGE) 


150 


50 


100 


9 


GREEN-YELLOW 


210 


50 


100 


10 


GREEN-CYAN 


270 


50 


100 


1 1 


BLUE-CYAN 


330 


50 


100 


12 


BLUE-MAGENTA 


30 


50 


100 


13 


RED-MAGENTA 


90 


50 


100 


14 


DARK GRAY 





33 





15 


LIGHT GRAY 





66 






Errors 

TG00 (Level 0) : Unrecognized command (4114 only) . 

TG10 (Level 2): Surface does not ex ist (has not been defined 

with a <set-sur f ace-def initions> command) . 

TG11 (Level 2) : Invalid sur face number . (Must be -1, or in 

the range from 1 to 4). 
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TG21 (Level 2): Invalid color-mixtures array. (The array 

count must be a multiple of four in the 
range from through 65532. The first < int> 
in each group of four < int>s must be or a 
color-index in the range from 1 to 32767. 
The other three <int>s must be valid HLS, 
RGB , or CMY values , according to the most 
recent <set-color-mode> command . If the HLS 
system is in effect , the "hue" parameter 
must be in the range from -32768 to +32767, 
while the 11 lightness" and "saturation" par- 
ameters must be in the range from to 1 00. 
If the RGB or CMY system is in effect , *hen 
all three color mixture parameters must be 
in the range from to 1 00. ) 

TG22 (Level 3): Parameter 2 memory error . (Out of memory 

wh ile parsing the color-mixtures array . ) 



References 



<Se t- background -col or > command . 
<Set- background -gray-lev el > command . 
<Set-color-mode> command . 
<Set-sur f ace-def initions> command . 
<Set-sur face- gray-lev el s> command . 
Appendix D, "The Super-Surface." 
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<Set-Surfaee-»Definitions> Command 



4112, 4113 



SYNTAX 



<set-sur face- definition s> 



(ESC) (R)(D) 

< in t- array: sur face-def s > 



< in t~» array : sur f ace-def s> 



<int : number- of- sur f aces > 
[ <sur face- spec if ier> . . . ] 



<sur face- spec if ier> = <in t : number-of-bit-planes> . 
PARAMETERS 

Sur face~Def s . An array of <int>s specifying the number 
of bit planes for each sur face . The first <int> in the 
array (the array count) tells how many writing sur- 
faces the terminal is to have. Subsequent < int> s 
specify the number of bit planes for their respective 
sur faces . 



Description 

The < se t- sur face-def in it ion s> command erases the screen and 
sets the number of bit planes in each surface. Initially, 
all planes are allocated to one surface. Normal priority is 
front to back, with Surface 1 being in front. 

Here, the "number of bit planes" in each surface determines 
the maximum color-index which may be written into pixels on 
that surface. A surface with only one bit plane is allowed 
color- ind ices and 1 only; a surface with two bit planes is 
allowed color- ind ices 0, 1, 2, and 3; while a surface with 
three bit planes is allowed any color-index from to 7. In 
a 4113, a surface with four bit planes is allowed any color- 
index from to 15. 

If more planes are specified than the terminal has, the 
excess specifications are ignored'. 
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Example* To assign one bit plane to surface one , and two bit 
planes to surface two , issue the following command: 

<se t- sur f ace- definitions : (1 , 2 ) > 

= (ESC) (R)(D)<int-array : (1 ,2)> 
= (ESC) (R ) (DXint :2><int : 1><int :2> 
= (ESC)(R)(D)(2)(1 )(2) . 

In this example , sur face three does not exist; an error will 
occur if you attempt to reference sur face three in another 
command . 

Another Example. To assign one bit plane to sur face one , 
zero bit pi anes to sur face two , and two bit pi anes to 
sur face three , i ssue the following command : 

< set- sur face- definitions : ( 1 , , 2)> 

= (ESC) (R)(D)<int-array : (1 ,0,2)> 

= (ESC) (R ) (DXint :3><int: 1><int :0><int:2> 

= (ESC) (R)(D)(3)(1 )(0)(2) . 

In this example , sur face two has zero bit pi anes . It is , 
however , po ssible to create a view whose viewport is on 
sur face two . In that case , nothing in that view would be 
visible on the screen . Thi s may be useful for double 
buffering . A picture can be built in a view whose viewport 
is on a sur face to which zero bit pi anes are assigned . 
Later , another < set- sur face-def initio ns> command can assign 
bit planes to that sur face , whereupon the picture becomes 
visible. 
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Initializing Gray-Levels (41 12 Terminal) . In the 4112 termi- 
nal , the <set-surface-definitions> command also assigns a 
gray-level to each possible color-index on each surface 
being defined. In all cases, color-index zero is 
"transparent." The other color-indices are assigned gray- 
levels as follows : 



For 


a 


one-bit- plane surface: 


Index 


1 : 


= 90% lightness 


For 


a 


two-bit-plane surface: 


Index 


1 : 


= 30% 






Index 


2 : 


: 60% 








Index 


3 : 


= 90% 


For 


a 


three-bit-plane surface: 


Index 


1 : 


= 25% 






Index 


2 : 


= 30% 








Index 


3 = 


= 45% 








Index 


4 : 


= 60% 








Index 


5 = 


= 70% 








Index 


6 : 


= 85% 








Index 


7 : 


= 90% 
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Initializing Color-Mixtures (4113 Terminal) . In the 4113 
terminal, the < set- sur face- de fin it ion s> command assigns a 
color mixture to each possible color-index on each sur face 
being defined': 

Color-Index Color Mixture Color Coordinates 







H 


L 


S 





Transparent 








1 


WHITE 





100 





2 


RED 


120 


50 


1 00 


3 


GREEN 


240 


50 


100 


4 


BLUE 





50 


100 


5 


CYAN 


300 


50 


100 


6 


MAGENTA 


60 


50 


1 00 


7 


YELLOW 


180 


50 


1 00 


8 


RED-YELLOW (ORANGE) 


150 


50 


100 


9 


GREEN-YELLOW 


210 


50 


100 


10 


GREEN-CYAN 


270 


50 


100 


1 1 


BLUE-CYAN 


330 


50 


100 


12 


BLUE-MAGENTA 


30 


50 


100 


13 


RED-MAGENTA 


90 


50 


100 


14 


DARK GRAY 





33 





15 


LIGHT GRAY 





66 






Initializing Visibility* The <set-sur face- definition s> com- 
mand causes each surface it defines to be visible, as if a 
< set-sur face- visibility> command were issued for that sur- 
face. 

Initializing Surface Priorities. The <set-surface- 

def initions> command assigns the following default priori- 
ties to the surfaces it defines. Surface one is in front. 
Surface two , if it ex ists , is behind sur face one . Surface 
three , if it exists, is behind surface two; and so on. You 
can change this ordering with the < set-sur f ace- prior it ies> 
command. 
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Defaults 



Parameter 
Number 

1 



As Shipped 
From Factory 

1 , 3, or 4, 

depending on 
the number of 
bit planes 
installed . 



On Power-Up 



1, 3, or 4, 
depending on 
the number of 
bit planes 
installed . 



If the Parameter 
is Omitted 

Error RD11 



Error s 



RDOO (Level 0): Unrecognized command. (The terminal is not a 

4112 or 4113.) 

RD10 (Level 2): Occupied undefined surface. (This command 

would have resulted in a dialog area 
viewport, pixel viewport, or numbered graph- 
ic viewport residing on an undefined sur- 
face.) 

RD11 (Level 2): Invalid <int-array> parameter. 

In the 4112, the array count must be in the 
range from 1 to 3, and the < int> s in the 
array must be in the range from to 3- 

In the 4113, the array count must be in the 
range from 1 to 4, and the <int>s in the 
array must be in N the range from to 4. 

RD12 (Level 3): Parameter 3 memory error. (Out of memory 

while trying to parse the < int- arr ay> param- 
eter.) 

Re f er ences 

<Se t- sur face- col or- map> command . 
<Set-sur face-gray-levels> command . 
<Set-sur face-pr iorities> command . 
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<Set-Sur face-Gray-Lev el s> Command 4112, 41 13 



SYNTAX 

<se t- sur f ace-gray-levels>'' 

= (ESC)(R)(G) 

<int: sur face-number> 

< int+-arr ay : ind ices- and- gray- lev el s> . 
PARAMETERS 

Surface-Number (4112: 1 to 3; 4113: 1 to 4) . Names the 

surface for which gray-levels are being specified . 

Ind ic es- An d-Gr ay-Levels . Thi s array holds an even 
number of < int+> parameters . The < int+>s are consid- 
ered in pairs , with the first < int+> in each pair 
being a color-index , and the second < int+> in the pair 
specifying the gray-level ( range to 1 00 ) for that 
color- index . 



Description 

This command defines the color- ind ices for a par ticul ar 

sur face , assigning to each color- index a correspond ing shad e 

of gray ( gray-level) . 

Color-Indices and Gray-Levels. Think of the color- indices as 

ink bottles which can hold different shades of ink . Each 

wr iting surface has its own set of ink bottles , into which 

you can dip your pen when when drawing lines on that 

sur face . The number of ink bottles for a given sur face is 

two raised to the power N , where N is the number of bit 

pi anes assigned to that sur face by the <set-sur face- de fin i- 

tions> command . 
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Ink bottl e number zero ( color- index zero) always holds " ink 
eradicator That is, whenever you draw a line in color- 
index zero , that 1 ine is transparent , wi ping out any previ- 
ous 1 ine drawn on that sur face . 

The < set- sur f ace- gray- lev el s> command loads different inks , 
in shades of gray ( gray-levels) into a surface's ink 
bottles. (In the 4113, another command , <set-sur face- col or- 
map> , lets you load colored inks into the ink bottles . ) 

In the 4112, there are fifteen d istinc t gray inks ( shades of 
gray) which may be loaded into a surface's ink bottles with 
the < set- sur f ace-gr ay-levels> command . In the 4113, sixteen 
d istinc t shades are available . In both terminal s , you spec i- 
f y a shade of gray with a number in the range from to 1 00 ; 
this number is the "gray-level" coord inate used in the <set- 
sur face- gray-lev el s> command . (This corresponds to the 
"lightness" coord inate in the 4 1 1 3 1 s hue -lightness- satura- 
tion color coord inate system . ) 

Figure 4-22 shows the shades of gray available in the 4112 
and the 4113. 
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4112 



4113 



95% — 100% 



88% — 94% 



81% — 87% 



75% — 80% 



68% — 74% 



61%— -67% 



54% — 60% 



c/> 

UJ J 

H > 48% — 53% 
x w 
o - 1 



41% — 47% 



34% — 40% 



27% — 33% 



21% — 26% 



14% — 20% 



7% — 13% 



0% — 6% 




WHITE 



BLACK 



94% — 100% 



88% — 93% 



82% — 87% 



75% — 81% 



69% — 74% 



63% — 68% 



57% — 62% 



m 50% — 56% 

UJ -J 

O ^ 44% — 49% 



38% — 43% 



32% — 37% 



25% — 31% 



19% — 24% 



13% — 18% 



7% — 12% 



0% — 6% 



WHITE 




BLACK 



Figure 4-22. Shades of Gray Available in the 4112 and the 4113. 



4-536 



REV, DEC 1981 4110 SERIES COMMAND REFERENCE 



ALPHABETICAL LISTING 



Surface-Number Parameter. The first parameter is an <int> 
naming the writing surface for which gray-levels are being 
specified. That is, it names the surface whose ink bottles 
( color- ind ices) are to be filled with various inks (shades 
of gray) . 

Indices-and-Gr ay-Lev els Parameter. The second of the com- 
mand's parameters is an < int-arr ay> holding pairs of num- 
bers. The first number in each pair is a color index, while 
the second number in the pair is a gray-level: a number in 
the range from to 100. The gray-levels are the 
"percentages of lightness 11 shown in Figure 4-22. In the 
4113, they correspond to the "lightness" coordinate in the 
HLS color coordinate system. (See the description of the 
<set-sur f ace-color-map> command, and Appendix ??, for more 
information on the 4 1 1 3 1 s color coordinate systems.) 
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Defaults 



In the 4112, inks in shades of gray are placed in each 
surface's ink bottles on power-up or when a <set-sur face- 
def initions> command is executed . These inks are as follows: 

One-Bit-Plane Surface 



Color-Index Gray-Level 

Transparent (ink erad icator ) 

1 90% (white) 

Two-Bit-Plane Surface 

Color-Index Gray-Level 

Transparent (ink eradicator) 

1 30% (dark gray) 

2 60% (light gray) 

3 90% (white) 

Three-Bit-Plane Surface 

Color-Index Gray-Level 

Tr anspar ent ( ink erad icator ) 

1 25% 

2 30% 

3 45% 

4 60% 

5 70% 

6 85% 

7 90% (white) 



In the 4113, coloured inks are placed in each sur faces 1 s ink 
bottles on power-up or when a < set- sur f ace-def in it io ns> 
command is executed . See the descriptions of the < set- 
surf ace-def in it ion s> and < set- sur f ace-color-map> command s 
for details . 
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Errors 



RGOO (Level 0) 

RG10 (Level 2) 

RG11 (Level 2) 

RG21 (Level 2) 



RG22 (Level 3) 
Re f erences 



Unrecognized command 
4112 or a 4113.) 



(The terminal is not a 



Surface does not exist (has not been defined 
wwith a <set-surface-definitions> command ) . 

Inval id surface number . (In the 4112, must 
be in the range from 1 to 3 • In the 4113, 
must be in the range from 1 to 4 . ) 

Invalid sur f ace- gray-lev els array . (The ar- 
ray count must be even ; the first < int+> in 
each pair must be a color- index in the range 
from 1 to 65535 ; the second < int> in each 
pair must be a valid gray-level : a number in 
the range from to 1 00 ) . 

Parameter 2 memory error . (Out of memory 
while parsing the < int-arr ay> parameter • ) 



<Color-map> command . 

<Se t-background-color> command . 

<Se t-bac kg round -gray- lev el > command . 

<Se t- sur f ace-def initions> command . 
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<8tt-Surfice-Prlorlfcie§» @@ff}insrid 4112, 4113 



SYNTAX 

<set-sur face- prior i tie s> = (ESC) (R ) (N ) 

<int-array : prior ities> . 

PARAMETERS 

Priorities. The <int>s in this array are grouped in 
pairs. The first <int> in each pair is a sur face 
number , while the second < int> of the pair is a 
priority number for that surface. In the 4112, the 
surface numbers and priority numbers may range from 1 
to 3; in the 4113, they may range from 1 to 4. 



Description 

This command lists the sur faces , f r ont to back ; it deter- 
mines which of the transparent wr iting sur faces are " in 
front" of others , and which are " behind" other sur faces . 

Objects ( especially panels) drawn on one sur face 
will obscure objects drawn on a surface which is "behind" 
that surface . (In the 4113, this is true only if the <set- 
color-mode> command's "overlay mode" setting is OPAQUE rath- 
er than SUB TRACTIVE OR ADDITIVE.) 

Surface Priorities Array. The < int-arr ay> parameter holds an 
even number of integers , which are regarded in pairs . The 
first integer in each pair is a sur face number ; the second 
integer in the pair is a pr ior ity number for that sur face . 
Each surface is " in front of" all sur faces which have a 
larger pr ior ity number than it , and "behind" all sur faces 
which have lesser pr ior ity numbers . 
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Example. Suppose we want surface 3 to be in front, and 
surface 2 in back, with surface 1 in between. Then surface 3 
should be assigned priority 1, surface 1 should be assigned 
priority 2, and surface 2 should be assigned priority 3- We 
would issue the following command: 

<set- sur face-priorities : surface 3, priority 1; 
surface 1, priority 2; surface 2, priority 3> 

= (ESC) (R)CNXint-array : ( 3 , 1 , 1 , 2 , 2 , 3 ) > 

= (ESC) ( R ) (N )< int : 6>< in t : 3><in t : 1 Xint : 1><int:2Xint:2Xint 
= (ESC) (R)(N)(6)(3)(1 ) (1 ) (2 ) (2 ) (3 ) . 

Special Cases. If two surfaces are assigned same priority, 
then the lower-numbered surface is deemed to be in front of 
the higher-numbered surface. If more than one priority is 
assigned to the same surface, then the last priority 
assigned that surface is the one which has effect. 



Defaults 

When multiple surfaces are defined (with the < set- sur f ace- 
definitions) command), the surface priorities are set as 
f olllows . Surface 1 is the front surface. Surface 2, if it 
exists, is behind surface 1. Surface 3, if it exists, is 
behind surface 2; and so on. 

On power-up, there is only one surface, surface number one. 
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Errors 



RNOO (Level 0): Unrecognized command . (The terminal is not a 

41 12 or a 41 13. ) 

RN 1 (Level 2): Sur face does not ex ist ( has not been defined 

with a < set- sur face- definitions> command ) . 

RN 1 1 (Level 2): Invalid sur face pr ior ities array . ( In the 

4112, each in the array must be in the range 
from 1 to 3 • In the 4113, each <int> must be 
in the range from 1 to 4.) 

RN 1 2 (Level 3 ) : Parameter 1 memory error . (Out of memory 

wh i 1 e parsing the < int-arr ay> parameter . ) 

Re f erences 

<Se t-sur face-definitions> command . 
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<Set-Surface-Visibility> Command 



SYNTAX 

<set-surface-visibility> = 

= (ESC)(R)(I) 

<int-array : sur face- numbers- and- vi sib il it ies> . 

PARAMETERS 

Sur f ace-Number s-And-Vi sibil i ties . This <int-array> 

holds an even number of < int> parameters, which are 
regarded in pairs. 

The first <int> in each pair is a sur face number . In 
the 4112, this must be in the range from 1 to 3; in 
the 4113, it must be in the range from 1 to 4 . 

The second < int> in each pair spec if ies the visibil ity 
mode , and must be in the range from to 2: 

= invisible . 

1 = visible . 

2 = blinking ( alternating) between "visible" and 
" invisible . " 



Description 

This command changes the visibil ity of one or more sur faces 
without affecting sur face pr ior it ies or the visibility at- 
tributes of any segments in the sur faces . Normally , a 
sur face is v isible ( visibil ity mode 1). If a sur face is 
invisible ( visibil ity mode 0), then no obj ects on that 
sur face are displayed ; nor can segments d ispl ayed on an 
inv isible sur face be picked dur ing a GIN operation . Vi sibil- 
ity mode 2 causes a sur face to " blink , " or alternate between 
being visible and being inv isible . 
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This command is primarily for use in double buffering . It 
may also be used to provide an alternate , high-speed way to 
highlight segments. (Rather than issue a < se t- segment- hi gh- 
lighting> command in order to cause a segment to blink, 
instead d ispl ay the segment in a view whose v iewpor t is on a 
blinking surface J 



De f aul ts 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 1,1 1,1 Error RI1 1 



Error s 



RI00 (Level 0): Unrecognized command . (The terminal is not a 

4112 or a 4113.) 

R1 1 (Level 2): A sur face number in the < int- arr ay> is for a 

surface which does not ex ist ( that is , a 
sur face , which has not been defined with a 
< set-sur f ace-def init ions> command ) . 

RI 1 1 (Level 2): Inval id <int-array> . (The <int-array> 

consists of ( surface number , v isib il ity ) 
pairs . In the 4112, " sur face number" s must 
be in the range from 1 to 3; in the 4113, 
they must be in the range from 1 to 4 . In 
both terminal s , the " visibil ity" < in t> s must 
be in the range from to 2 ) . 

RI 1 2 (Level 3 ) : Parameter 1 memory error . (Out of memory 

while parsing the <int-array> parameter . ) 



Re f er ences 
command . 
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<Set-T>blet-Size> Command (Options 13 and 14, 

version 2 or higher) 



SETUP Mode Name: TBSIZE 



SYNTAX 



<set-tablet-size> 

= (ESC) (I)(N) 

< int : tablet-active-area-selec tor> . 

PARAMETERS 

Tablet- Active- Area-Selector (0, 1 , or 2), 

2 = LARGE ; the tablet operates as an option to a 
4 1 1 0-ser ies terminal . The active area of the Option 13 
tablet is 121 square inches ( 1 1 in x 1 1 in , or 279 mm 
x 279 mm) . The active area of the Option 14 tablet is 
1200 square inches (30 in x 40 in , or 762 mm x 1016 
mm) . 

1 = SMALL ; a smal ler active area is used , to 
emulate more closely the 4953 and 4954 tablets used 
with earlier Tektronix 401 0-ser ies terminals . The Op- 
tion 13 tablet emulates the 4953 tablet , with an 
active area of 105 square inches ( 1 0. 24 in x 1 0. 24 in , 
or 260 mm x 260 mm) . The Option 14 tablet emulates the 
4954 tablet , with an active area of 1 1 80 square inches 
(30.72 in x 38.4 in, or 780 mm x 975 mm). 

= AUTOMATIC; when the tablet is enabled with an 
< enable-GIN> command , the 1 arger active area is used . 
When the tablet is enabled with the < enable-4953- 
tablet-GIN> command , the smaller active area is used . 



Description 

The graphic tablets included with Options 13 and 1 4 have a 
slightly larger active area than the TEKTRONIX 4953 and 4954 
tablets used with earlier 401 0-ser ies Tektronix terminals . 
To emulate the earlier tablets more closely , the <set- 
tablet-size> command is included in versions 2 and above of 
the firmware for Options 13 and 1 4 . 
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In LARGE mode (mode 2) , the entire active area of the Option 
13 or 14 tablet is used . This could be a problem when 
running application programs developed for the earlier 4953 
and 4954 tablets , especially if tablet overlays have been 
developed for use with those programs. (Because the Option 
13 tablet has a larger active area than a 4953 tablet , it is 
inappropriate to use the same tablet overlay.) 

In SMALL mode (mode 1), a slightly smaller portion of the 
tablet sur face is used . This emul ates the smaller active 
area of the 4953 or 4954 tablet • That way, a tablet overlay 
developed for use with a 4953 tablet can also be used with a 
4 1 1 0-ser ies Option 13 tablet • Likewise , i n mode 1 , a tablet 
overlay developed for a 4954 tablet can be used with an 
Option 14 tablet . 

In AUTOMATIC mode (mode ) , the "large" or " small" active 
area is automatically sel ected , accord ing to whether the 
tablet is enabled with the <enable-GIN> command , 
(ESC) (I)(E)<intXint>, or the <enable-4953~tablet-GIN> com- 
mand , (ESC) ( !)<ASCII-character>. 

The SETUP mode name for this command is TBSIZE . That is , in 
SETUP mode, you would type "TBSIZE LARGE" instead of issuing 
a <set-tablet-size: 2> command . Likewise , " TBSIZE SMALL" is 
equivalent to <set-tablet-size: 1>, and "TBSIZE AUTOMATIC" 
is equivalent to <set- tab let- size: 1 >. 



Defaults 



Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 (AUTOMATIC) (AUTOMATIC) (AUTOMATIC) 



Errors 



INOO (Level 0): The < set- tab let- mod e> command is not in- 
stalled . (This command requires r version 2 or 
above of the Option 13 or 14 firmware . ) 

IN1 1 (Level 2): Invalid parameter, (Must be 0, 1 , or 2. ) 

References 

<Enable-4953-Tablet-GIN> command . 
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<Set-Tablet-Header-Characters> Command (Options 13 and 14) 



SETUP Mode Name: TBHEADERCHARS 



SYNTAX 

<set- tablet- head er- char act er s> 

= (ESC) (I)(H) 

< in t : character- set- selec tor > . 

PARAMETERS 

Character-Set-Selector (0 or 1). 

= LETTERS - (M) , ( J) , and (0) 

1 = CONTROL - (GS), (SUB) , and (US) 



Description 

This command selects the "header" characters used in <4 953- 
tablet-GIN-report> s and the "key" characters used in <GIN- 
stroke-repor t> s . 

Header Characters . If the <int> parameter in the let- 
table t- header- char act ers> command is zero (the default ) , then 
the header characters in <4 953-tablet-GIN-repor t> s are ( M) , 
(J), and (0). 

If the < int> parameter is one , then the header characters 
are (GS) , (SUB) , and (US) . 



4110 SERIES COMMAND REFERENCE 



REV, MAR 1982 



4-545 



ALPHABETICAL LISTING 



c 

Key Characters . If the <int> parameter in the < set- tablet- 
head er- char ac ter s> command is zero (the default ) , then the 
key characters in <GI N- stroke- repor t> s are: 

(M) , ( Z) , (1), (2 ) , or (3) for the first point in a 
stroke . The character ( M) is used with the tablet pen , 
and the characters ( Z) , ( 1 ) , (2 ) , and (3) are used 
with the optional tablet cursor/ 

(J) for subsequent po ints in a stroke . 

(0 ) for the last po int in a stroke . 

A <se t- tab let- header- char ac ter s: 0> command , however , can 
change these as follows : 

( M) , ( Z) , ( 1 ) , (2 ) , or (3 ) for the first point in a 
stroke . (These characters do not change . ) 

(SUB) for subsequent po ints in a stroke . 

(US) for the last po int in a stroke . 



For more details , see the <GIN-str oke- repor t> and <4953- 
tablet-GIN-repor t> descriptions ? el sewhere in this section . 



Defaults 

Parameter As Shipped On 

Number From Factory 

1 



Power-Up If the Parameter 

is Omitted 
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Errors 



IHOO (Level 0): Unrecognized command. (Tablet option is not 

installed . ) 

IH11 (Level 2): Invalid parameter. (Must be or 1 ; in SETUP 

mode, must be CONTROL or LETTERS.) 

Re f erences 

<Enable-GIN> command . 
<Enable-4953-tablet-GIN> command . 
<GIN-str oke-repor t> 

<4 953-tablet-GIN-report> 
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<Set-Tablet-Status-Strap> Command (Options 13 and 14) 



SETUP Mode Name: TBSTATUS 



SYNTAX 




<set- tablet- stat us- strap> = 


(ESC) (I)(T) 

< int : strap-setting> . 


PARAMETERS 




Strap-Setting (0 or 1). This 
STATUS strap on a TEKTRONIX 
controller board : 


parameter emul ates the 
4953 or 4954 tablet 


= STATUS OUT 

1 = STATUS IN 




Description 



This command helps a 41 1 0-series terminal emulate TEKTRONIX 
401 0-ser ies terminal s which have accessory 4953 or 4954 
graphic tablets . The command emulates the STATUS strap on 
the 4953/4954 tablet controller board . (This strap controls 
whether not a terminal status byte is sent when the tablet 
pen is 1 if ted away from the tablet . ) 



NOTE 

This command only affects the <4 953- tablet- stat- 
us-report>s sent to the host when the terminal 
has been enabled for graphic input with an 
<enable-4953-tablet-GIN> command . This command 
does not affect normal GIN operation with the 
<enable-GIN> command . 
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If the < in t> parameter is zero, the terminal emulates the 
STATUS OUT setting of the 4953 tablet 1 s STATUS strap. In 
this case, a status byte _is not sent when the tablet pen 
leaves presence. 

If the < in t> parameter is one, the terminal emulates the 
STATUS IN strap setting. In this case, if the tablet has 
been enabled for "disable on leaving presence" mode, then a 
status byte i_s sent when the tablet pen leaves presence. 

For more information, see the description of the <4 953- 
tablet~status-report> , elsewhere in this section. (See also 
the TEKTRONIX 4953/4954 Graphics Tablet Instruction Manual.) 



Defaults 



Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

11 1 1 



Errors 



ITOO (Level 0): Unrecognized command . (The tablet option is 

not installed . ) 

IT 1 1 (Level 2): Invalid strap setting (must be or 1). 



References 



<enable-4 953-tablet-GIN> 
<4 953-tablet-GIN-report> 

4953/4954 Graphics Tablet Instruction Manual 
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<Se t-Tex t-Index> Command 



SYNTAX 

<set-text-index> = (ESC)(M)(T) 

<int+ : text- index> . 

PARAMETERS 

Text-Index (0 to 65535)* In the 4112 and 4113, this is 
the color-index or color-index used for subsequent 
alphatex t and graphtex t . In all terminal s ( includ ing 
the 4114), the text- index determines which pen is used 
when text in a segment is sent to a plotter . ( See the 
< map- index- to- pen > command for details . ) 



Description 

The <set-text-index> command spec if ies the color- index ( in 
the 4112 and 4113) or pen index ( in the 4114) to be used for 
subsequent alphatex t and graphtex t . 

4114. In the 4114, the pen-index has no effect on the 
d ispl ay . However , it does affect which plotter pen is used 
when a picture is copied to an accessory plotter with the 
<plot> command . ( See <map- index- to- pen > for details . ) 

4112 and 4113. There is a max imum color- index for any 

par ticul ar wr it ing surface : one less than 2**M, where M is 

the number of bit pi anes assigned to that sur f ace . (See 

< set- sur f ace-def init ions> command . ) If a tex t- index greater 

than the max imum is used , the 4112 displ ays it as if it were 

the max imum color- index for that sur f ace . 
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Dot matr ix characters ( characters of alphatex t or string- 
precision graphtext) are written in the viewport of the 
current view as follows . Those dots within the character 
cell which are to be turned on ( that is , the dots which form 
the character) are wr itten using the current tex t index , as 
set by the most recent < set- tex t- index> command . Those dots 
wi thin the character cell which are to be turned off ( that 
is , the dots which form the background of the the char ac ter 
cell) are wr itten using the wi pe index for the current view. 
(See <set-view-attributes> for information about the "wipe 
index for the current view.") 

The < set- tex t- index> command has no effect on alphatex t in 
the dialog area . Instead , the appearance of d ialog area text 
is governed by the < set- dialog- area- index > command . 



Def aul ts 



Parameter 
Number 

1 



As Shipped 
From Factory 



On Power-Up 



4112 

4113 
41 14 



7; 
1; 

255. 



4112 
4113 
4114 



7; 

1; 

255. 



If the Parameter 
is Omitted 





Errors 



MT11 (Level 2): Inv al id tex t index . (Must be in the range 

from to 65535.) 

Re f erences 

<Map- index- to- pen> command . 

<Se t- sur face- gray-lev el s> command . 

<Set-background-gray-levels> command . 
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<Set-Tr an sm it-Del ay> Command 



SETUP Mode Name: XMTDELAY 



SYNTAX 

<set-transmit-delay> = (ESC)(N)(D) 

< int+ : tr ansmit-delay> . 

PARAMETERS 

Transmit-Delay (0 to 65535). The number of mil- 
liseconds which the terminal is to wait after send ing 
each 1 ine of text before it starts transmitting the 
next 1 ine of text. 



Description 

After send ing one of the end-of-message characters ( set by 
the < set-EOM-char s> command ) , the terminal pauses a short 
time before resuming transmission . The <set- tr ansmit-delay> 
time determines the duration of that " short time . " 

The actual del ay time may be up to 10 milliseconds greater 
than that specified , because of the resolution of the 
internal timer . 

If the terminal is using the bypass feature, the transmit 
delay should be large enough so that all host characters 
will be echoed before the transmit delay expires . Failure to 
set the delay long enough may result in characters which 
should have been bypassed getting to the terminal . 
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Defaults 



Parameter 
Number 



As Shipped 
From Factory 



On Power-Up 



If the Parameter 
is Omitted 



100 



Remembered 







Errors 



ND1 1 (Level 2): Inval id transmit delay time . ( Must be in the 

range from to 65535 milliseconds . ) 
No errors are detected for this command . 



References 

<En ter- bypass- mod e> command . 
<Se t-EOM-char s> command . 
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<Set-Tr ansmit-Rate-Limit> Command 



SETUP Mode Name: XMTLIMIT 



SYNTAX 






<set- tr ansmit-rate- 


limit> : 


= (ESC) (N)(L) 






< int+ : r ate-limit> . 


PARAMETERS 






Rate-Limit (1 10 to 


65535) . 


Transmit rate limit, in 


bits per second. 







Description 

The <set~ transmit- rate- limi;t> command imposes an upper bound 
on how fast the terminal may send characters to the host 
computer. This may be useful in circumstances where the host 
cannot process characters as fast as the terminal can send 
them over the communications line. 

Example* Suppose the transmit baud rate (set by the < set- 
baud-rates> command) is 1200 bits/sec - about 120 characters 
per second . Suppose further that a <set-transmit-rate-limit : 

300> command is sent to the terminal . Then , when transmit- 
ting characters to the host , the terminal will send each 
character at the full data rate (1200 bits/sec), but will 
space the characters apart so that the average bit rate is 
no more than 300 bits per second (about 30 characters per 
second ) . 
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Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

1 19200 Remembered Error NL11 

Errors 



NL11 (Level 2): Invalid transmit rate limit. (Must be in the 

range from 110 to 65535.) 

Re ferences 

<Set- baud- r ate s> command. 
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<Set-View-Attr ibutes> Command 



4112 



SYNTAX 



<set- view-attr ibutes> 



(ESC) (R)(A) 
<int : sur face-number> 
< int+ : wi pe- index> 
< int+ : border- index> 



PARAMETERS 

Surface-Number (4112: -1 to 3; 4113: -1 to 4) . 

Specifies the sur face on which the view's v iewpor t is 
located . 

Wipe-Index (0 to 65535). The color-index used for 
wiping ( erasing) the viewport . 

Border-Index (0 to 65535 ) . The color-index used for 
d ispl aying a border around the v iewpor t . 



Description 

This command applies to the 4112 and 4113. 

Thi s command sets the sur face , wipe index , and border index 
for the current view. Here , "current view" means the view 
most recently selected with the <select- view> command or the 
NEXTVIEW key. 

Surface Number . The first <int> parameter determines on 
which surface the view is to be displayed : that is , on which 
sur face the viewport for that view exists. The defaul t is 
sur face 1 . 

If " sur face zero" is specified , the current sur face for the 
view is left unchanged . 



4-556 



4110 SERIES COMMAND REFERENCE 



ALPHABETICAL LISTING 



If "surface -1" is specified, then a "super surface" is 
used. This super surface consists of all bit planes on all 
of the presently defined surfaces. The super surface is for 
use in advanced applications. If you plan to use the super 
surface , be sure to read Appendix D, which explains the 
super surface and its side effects. 

If a surface is specified which does not exist, then an 
error occurs. (A surface does not exist if it was not 
defined in the most recent < set-sur f ace-def initions> com- 
mand . ) 

Wipe Index • The second < int> specifies the "wi pe index" for 

the viewport of the specified view. This is the color-index 
to which all pixels in the viewport are set during an erase 
operation. The default is color-index 0, "transparent." 

There is a max imum color- index for any par ticul ar sur face : 
one less than 2**M , where M is the number of bit pi anes 
assigned to that sur f ace . If a wi pe ind ex greater than this 
max imum is specified , the 4112 uses the max imum ind ex as the 

wipe index . 

Border Index . The third < int> parameter specifies the color- 
index in which the viewport border is to be drawn . (The 
border is d rawn only if the BORDER key or < set-border- 
visibil ity> command has made the border visible . ) 

If a border index greater than the max imum index for the 
sur face is specified , the 4112 uses the max imum index as the 
border index . 

Def aul ts 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 







2 















3 



4112: 6; 
4113: 1. 



4112: 6; 
4113: 1. 
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Errors 



RAOO (Level 0): Unrecognized command. (The terminal is not a 

41 12 or a 41 13. ) 

RA 1 (Level 2): Surface does not exist ( has not been defined 

with <se t- sur face- definitions> command ) . 

RA 1 1 (Level 2): Invalid sur face number . (In the 4112, must 

be in the range from - 1 to 3; in the 4113, 
must be in the range from - 1 to 4 . ) 

RA21 (Level 2): Inv al id wipe ind ex . ( Must be in the range 

from to 65535. ) 

RA3 1 (Level 2): Inv al id border index . (Must be in the range 

from to 65535, 

Re f er ences 

BORDER key, 

<Se t- border- vi sib il ity> command . 
<Selec t- view> command . 
<Set- sur face- definition s> command . 
<Set-surf ace-color-map> command . 
<Se t- sur face- gray- lev el s> command . 

Append ix D, 11 The Super Sur face . " 
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<Set«Vlew-Display-Cluster> Command 4112,41 13 



SYNTAX 

<set-view-display~cluster> 

= (ESC)(R)(Q) 

<int-array: v iew-numbers> . 

PARAHETERS 

¥itw«Mynbers« An array of <int> parameters, specifying 
which of the terminal's views are to be clustered 
together,, Valid view numbers are in the range from -2 
to 64 f as follows: 

-2 Removes from the current view's cluster any 

views which are currently in that cluster . 

-1 Clusters all 64 possible views together in 

one display cluster . Any views which may 
later be created ( with the <select-view> 
command) will also be included in this dis- 
play cluster . 

Refers to the current view, as selected by 
the most recent <select-view> command . 

1 to 64 Numbers from 1 to 64 name specific individu- 

al views . A view need not ex ist to be 
included in a view cluster . (Later , when the 
view is created with the <select-view> com- 
mand , it will be includ ed in the view 
cluster) . 

If the view-number < int-array> has a count of zero 
(i.e. , is empty) , then all views are removed from all 
view display clusters . 
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Description 

In some circumstances, you may wish to have several views 
with identical windows for their window-viewport transforms* 
The <set-view-cluster> command lets you specify a list of 
views which are to have identical windows. Changing the 
window for any view in this "cluster" also changes the 
window for every other view in the cluster* Also , renewing 
any view in this cluster ( <renew-view> or <page> command , or 
PAGE key) also renews every other view in the cluster . 

This is especially useful when you have several views on 
different sur faces , describing different aspects of the same 
object* For instance , suppose you are using the terminal as 
a light table for preparing multi-layered etched circuit 
board layouts . In that case , views one , two , three, and four 
might have identical viewports on sur faces one , two , three , 
and four , respectively . View one would represent the top 
layer of a circuit board , while views two , three, and four 
would represent other layers of the same circuit board . In 
such an appl ication , you would want the framing keys , and 
the <set-window> and <page> commands , to affect all four 
views . That way , when you use the framing keys to zoom in on 
a part of the picture , the zoom operation affects al 1 four 
views , on all four surfaces . To accomplish this , you would 
cluster the four views together with the < set-»view-cluster> 
command: 

< set- view-display-cluster : ( 1 , 2, 3, 4)> 
= (ESC) (R)(Q)<int-array: ( 1 ,2,3,*0> 
= (ESC)(R)(Q)(4)(1)(2)(3)(4) . 

Thereafter , whenever you change the window for any one of 
these four views , the windows for the other three views also 
change. This happens whether you change the -window explicit- 
ly, with the <set-window> command , or impl icitly , with the 
VIEW, CTRL-VIEW, RESTORE, CTRL-RESTORE, OVERVIEW, or CTRL- 
OVERVIEW keys. 

Likewise , whenever you renew any of these four views , all 
the other views in the cluster are also renewed . This 
happens with the <renew-view> and <page> commands , and with 
the PAGE, VIEW, CTRL-VIEW, RESTORE, CTRL-RESTORE, OVERVIEW, 
and CTRL-OVERVIEW keys. 

Removing Specific Views from a Display Cluster. A view 
cannot belong to more than one display cluster . Thus , 
includ ing a view in one cluster automatically removes it 
from any other clusters . Consider , for instance , the follow- 
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ing commands: 

<set- view-display-cluster : ( 1 , 2 , 3 , ^ ) > 

< set- view-display-cluster : ( 3 , 4 , 5 , 6) > 
< set- view-display-cluster : (5 , 6 , 7) > 

The first command creates a display cluster consisting of 
views 1, 2, 3f and 4. The second command creates a cluster 
with views 3, 4, 5 , and 6; in doing so, it removes views 3 
and 4 from the first cluster . The third command creates a 
cluster with views 5, 6, 7* removing views 5 and 6 from the 
previous cluster as it does so. Thus, after all three 
commands have been executed, there are three display clus- 
ters, as follows: views 1 and 2; views 3 and 4; and views 5 , 
6 , and 7* 

fttmo¥ing All Views From All Clusters* If the <set-view- 
display-cluster> command's <int-array> parameter is empty, 
then all views are removed from all clusters . That is, to 
remove all views from all clusters, issue the following 
command : 

< set- view-display-cluster : empty-array> 

r (ESC) (R)(Q)(0) . 

Removing All Views From Only One Display Cluster . To remove 
all views from a single cluster, do the following: 

1 . Issue a <select-view> command to select one of the 
views in the cluster. 

2. Issue a <set-view-display-cluster> command containing 
the special view number, minus two: 

<set- view-display-cluster : ( -2) > 

= (ESC) (R) (QXint-array : (-2)> 

= (ESC)(R)(Q)(1)(») . 



Defaults 

When a view is first created, if it has not been specified 
by a previous <set-view-display-cluster> command , it is not 
clustered with any other views. When the terminal is powered 
up or reset , no view is in any cluster . 
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Errors 



RQOO (Level 0) : Unrecognized command . (4114 only). 

RQ1 1 (Level 2): Invalid <int-array> parameter * (Each view 

number in the <int-array> must be in the 
range from -2 to 64 . ) 

RQ12 (Level 3): Out of memory while parsing the <int-array> 

parameter. 

References 

<Delete-view> command* 
OVERVIEW key. 
<Page> command . 
PAGE key, 

<Renew-view> command . 
RESTORE key. 
<Select-view> command . 
VIEW key. 
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<Se t-Viewport> Command 



4112, 4113 



SYNTAX 

<set-viewport> = (ESC)(R)(V) 

<xy : lower- left- corner > 
<xy : upper- right- corner > . 

PARAMETERS 

Lower-Left-Corner (X = to 4095, Y = to 3071). 
Location of one corner of the current view's v iewpor t , 
in normal ized screen coord inates . 

Upper-Right-Corner (X = to 4095, Y = to 3071 ) . 

Location of the opposite corner of the v iewpor t , in 
normal ized screen coord inates . 



Description 

The command is available only in the 4112 and 4113 termi- 
nals . 

Thi s command sets the position of the current view's 
v iewpor t in raster memory space . 

The two < xy> parameters specify the positions of the lower 
left and upper right corners of the v iewpor t . ( Actually , any 
two opposite corners will do ; the terminal sorts the two x- 
coord inates and the two y-coordinates in the proper 
order . ) 

Ev en though the v iewpor t ex ists in 640 by 480 raster memory 
space , the v iewpor t corners are specified in a 4096 by 3072 
"normal ized screen coord inate space . 11 In this space , x- 
coord inates range from to 4095 , and y-coord inates range 
from to 3071. (The terminal internally converts these 
normal ized screen coord inates into the correspond ing 640 by 
480 "raster memory space" coord inates . 
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NOTE 



Changing the viewport changes the loca- 
tion on the screen where existing seg- 
ments are displayed . However , segments 
that are visible when the viewport 
change occurs do not automatically move 
to their new screen locations. To make 
the terminal redraw segments at their 
new screen locations , you should issue a 
<renew-view> or <page> command immedi- 
ately after changing the viewport . 

If you don 1 1 do this , and the f ixup 
level is greater than or equal to 4 , 
then moving a segment may not cause that 
segment 1 s old image to be properly re- 
moved from the screen . Multiple images 
of the segment will appear . The remedy 
is to issue <renew-view> or <page> ei- 
ther immediately after the <set- 
viewport> command or immediately after 
moving a segment . 



De f aul ts 



Parameter 
Number 



As Shipped 
From Factory 



On Power-Up 



If the Parameter 
is Omitted 



(0,0) 



(0,0) 



(0,0) 



2 



(4095,3127) 



(4095,3127) 



(0,0) 
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Errors 



RVOO (Level 0): Unrecognized command, (The terminal is not a 

4112 or a 4113.) 

RV01 (Level 2): Invalid <Se t- v iewpor t> command. (The 

viewport must not be more than eight times 
larger than the current window.) 

RV11 (Level 2): Invalid "lower left" corner. (X must be in 

the range from to 4095 , and Y in the range 
from to 3071 . ) 

RV21 (Level 2): Inv al id " upper right" corner . (X must be in 

the range from to 4095 , and Y in the range 
from to 3071 . ) 

Re f erences 

<Delete- view> command . 
<Selec t- view> command . 
<Set- view-attr ibutes> command . 
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<Set-Window> Command 4112, 4113 



SYNTAX 

<set-window> = (ESC)(R)(W) 

< xy : lower- left- cor ner > 
<xy : upper-r ight- corner > .■■ 

PARAMETERS 

Lower-Left-Corner (X = to 4095, Y = to 4095) . 

Specifies one corner of the window in terminal space 
for the current view. 

Upper-Right-Corner (X = to 4095, Y = to 4095) . 

Specifies the opposite corner of the window. 



Description 

The command is available only in the 41 12 and 4113 termi- 
nals . 

This command sets the boundaries of the current view's 
"window" in terminal space . ( The window is the rec tangul ar 
r eg ion in 4096~by-4095 terminal space whose contents are 
d ispl ayed in a "viewport" on the screen . ) 

The " lower left" and " upper right" <xy> parameters specify 
two oppo site corners of the window. ( Ac tually , these may be 
any two opposite corners ; the terminal sorts the two x- 
coord inates and the two y-coord inates in the proper order . ) 

Specifying a Window of Zero Width . If the rectangle speci- 
fied has zero width ( that is , if the the two x-coord inates 
are equal ) , then a wid th is cho sen for the window such that 
the window ( in terminal space) will have the same aspect 
ratio ( ratio of height to width) as the correspond ing 
viewport ( in raster memory space) . In that window, Xmin ( the 
x-coord inate of the lower left corner ) is the x-coord inate 
spec if ied in the command . Xmax ( the x-coord inate of the 
upper right corner ) is automatically chosen so that the 
window is the same shape as the v iewport . 
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Specifying a Window of Zero Height. Likewise, if the two 
<xy> parameters specify a rectangle of zero height (that is, 
if the two y-coord inates are equal), then a height is chosen 
for the window such that the window (in terminal space) will 
have the same shape as the corresponding viewport (in raster 
memory space) «, In that window, Ymin is the y-coordinate 
specified in the command's two < xy> parameters. Ymax is 
chosen so that the window has the same shape as the 
viewport. 

Specifying the "Default" Window, If both width and height 
are zero (that is, if both "lower left" and "upper right" 
refer to the same point), then a window is selected which 
extends from X=0 to X=4095, and from Y=0 to Y =3127. (This 
is the same "default" window which is set when the terminal 
is turned on . ) 

NOTE 

Changing the window changes the location 
on the screen where existing segments 
are displayed . However, segments that 
are visible when the window change oc- 
curs do not automatically move to their 
new screen locations. To make the 
terminal redraw segments at their new 
screen locations, you should issue a 
<renew-view> or <page> command immedi- 
ately after changing the window. 

If you don't do this, and the fixup 
level is greater than or equal to 4, 
then moving a segment may not cause that 
segment's old image to be properly re- 
moved from the screen. Multiple images 
of the segment will appear. The remedy 
is to issue <renew-view> or <page> ei- 
ther immediately after the <set~window> 
command or immediately after moving a 
segment. 
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Effect On Other Views in the Same View Display Cluster. In 
the 4113 terminal , views may be grouped into "view display 
clusters . " (See the < set- v iew-d ispl ay- clustery command for 
details . ) If the current view belongs to a view display 
cluster, and a < se t-window> command is issued, then that 
<set-window> command sets the window not only for the 
current view, but also for all other views in that cluster . 

"Clipping 11 in the 4112 and 4113. The 4112 and 4113 terminals 
perform a 11 wind ow- viewport transform" on each visible 
segment. That is , for each segment defined in 4096-by-4096 
"terminal space" coord inates , the terminal computes an " im- 
age" of that segment in 640-by-480 raster memory space . The 
window coord inates (in terminal space) and the viewport 
coord inates ( in raster memory space) together define this 
window-viewport transform . Those parts of the image in 
raster memory space which fall outside the current v iewpor t 
are " clipped ; " that is , those par ts of the image are not 
d ispl ayed . 

If the window ( in terminal space) is numerically 1 arger than 
the viewport (in '640-by-480 raster memory space) , there will 
be a small range of coord inates which are nominally outside 
the window, but whose images are inside the v iewpor t and are 
therefore d ispl ayed . Li kewi se , if the window is very small 
( numerically smaller than the viewport) , there will be a 
small range of coord inates which are nominal ly insid e the 
window, but whose images are outside the viewport and are , 
therefore , not d ispl ayed . 



Defaults 

Parameter As Shipped On . Power-Up; If the Parameter 

Mumber From Factory is Omitted. 

1 (0 ,0) Remembered (0,0) 

2 (4095,3127) Remembered (0,0) 
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Errors 



RWOO (Level 0): Unrecognized command. (The terminal is not a 

4112 or a 4113.) 

RW01 (Level 2): One of the four coordinates is outside the 

range to 4095 (possible only when using 
the NORMAL key) . 

Either the X or Y axis of the current 
viewport is more than 51.2 times the X or 
Y axis of the new proposed window, 

RW21 (Level 2): Invalid upper-right corner calculated by 

NORMAL. 



References 
command . 

<Se t- viewport> command . 
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<Se t-40 1 4-A1 phatex t-Si ze> Command 4114 



SYNTAX 








<set-401 4-al phatex t- si ze> : 


= (ESC) (8) 






or 


(ESC) 


(9) 




or 


(ESC) 


(: ) 




or 


(ESC) 


(; ) . 



Description 

This command is provided for compatibility with earlier 
TEKTRONIX terminals; it is equivalent to the <set-alphatex t 
si ze> command , as follows : 

(ESC) (8) = <set-alphatext-size: 10, 6, 28 > 
Fits at least 73 characters on one 1 ine . 

(ESC) (9 ) = <set-alphatext-size: 9, 6, 28 > 
Fits at least 80 characters per 1 ine . 

(ESC) ( : ) = <set-alphatext-size: 6, 4, 17 > 
Fits at least 120 characters per line . 

(ESC) ( ; ) = <set-alphatext-size: 5, 6, 18 > 
Fits at least 1 32 characters per 1 ine . 



References 

<Se t- alpha t ex t-si ze> command 
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<Set-401 4-Line-Style> Command 



SYNTAX 




<set-4014-line-style> = 


(ESC ) <char : 1 ine- st yl e- code> . 


PARAMETERS 




Line-Style-Code ( C) to 

with decimal equivalent 


(o) ) . An ASCII character 
in the range from 96 to 111. 


Description 



The <set-401 4~line-style> command is prov ided for compati- 
bility with host software written for earlier TEKTRONIX 
terminal s . It combines the features of the <set-line-style> 
command and ( for the 4114) the < set- line-wid th> command . 



This command specifies the type of 1 ine ( solid or dashed ) 
for all subsequent 1 ines and panel boundaries . 

ASCII characters 96 through 100 - C) through (d) - specify 
dotted , dot-dash , short-dash , and log-dash 1 ine styles , 
similar to those in the 4014. 

ASCII ADE values 101-1 03 (e - g) specify three additional 
1 ine styles not available in the earlier 401 0-ser ies termi- 
nals . 

On a 4114, ASCII ADE values 104 - 1 1 1 (h - o) specify the 
same d ash patterns as ASCII ADE v alues 96 - 1 03, but with 
the beam defocused : the chr ac ter s are drawn with a broader 
1 ine . 
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On all 41 10-series terminals (4112, 41 13, 4114), markers and 

text are always displayed with solid lines. The default line 
style is that for the character ( N ) : a solid focused 1 ine . 



Line Style Zero , Line Style One , Etc . For convenience , this 
manual refers to the different 1 ine styles by numbers , 
according to the following formul a : 

4014-line-style number = (ADE ) - 96 

where 

ADE = the ASCII dec imal equivalent of the second 

character in the <set-401 4-line-style> command 

Thus, 

<set-4CM4-line-style : 0> = (ESC) C ) 
<set-4014-line-style : 1> = (ESC) (a) 
<set-4014-line-style : 2> = (ESC) (b) 
<set-4014-line-style : 3> = (ESC) (c) 
etc . 



Re f erences 

<Set- line- sty le> command . 
<Se t- line-wid th> command . 
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SETUP Key 



Description 

Pressing the SETUP key puts the terminal in setup mode and 
turns on the light on the key. Pressing the key again 
removes the terminal from setup mode and extinguishes the 
1 ight . 

Pressing SHIFT-SETUP has the same effect as pressing SETUP. 
The SETUP key does not auto-repeat. 

When the d ialog area is not enabled , alphatext typed in 
SETUP mode is displayed together with graphics, and updates 
the graphic beam position. When the dialog area is enabled, 
alphatext typed in SETUP mode is displayed in the dialog 
area , and has no effect on the graphic beam position . 



References 

Description of setup mode in the Operator f s Manual for the 
par ticul ar terminal . 
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<Spool> Command 



SETUP Mode Name: SPOOL 



SYNTAX 

<spool> ? (ESC) (J)(S) . 

<string: sour ee- spec if ier> 

<string: i™epa7ator^^?I^> 
Xst.ring.: dTsTiliatTon^speci f ier>- * 

PARAMETERS 

Source~Specif ier . Specifies the source of -data for the 
<spool operation . Valid specifiers are the host compu- 
ter (HO:) , a disk file (e.g. , "F0:VIEW1") , or an RS- 
232 peripheral port (e.g. , "P0: lf ) . 

Separator-String • This must be the empty string, or 
the two-character string , ?f TO" . 

Destination-Spaeif ier • Specifies the destination for 

the <spool> operation . Valid specifiers are the host . 
computer (HO:) ,a disk file (e.g . , lf F1 : filename" ) , an 
RS-232 peirpheral port (e.g., "PO:") , or the color 
hardcopy interface ( "HC :" ) . 



Description 

This command is similar to the <copy> command , except that 
once initiated , the operation proceeds in the background 
mode , allowing the terminal to be used for other operations. 
All terminal activ ity can proceed while a spool operation is 
currently in progress . 

The <spool> command is , however , more restrictive than 
<copy> , in that it cannot be used to make a copy of the 
entire diskette. That is, a specific disk file must be named 
in the input specifier: " FO: FILENAME" is allowed, but "FO:" 
is not . 
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The <spool> command causes data from the specified input 
device (the device from which spooling is done) to be 
transferred to the specified output device (another disk 
file f the host , etc.). If either device is a disk, a file 
name must also be specified* 

The data are transferred as a string of 8-bit bytes. No 
format conversion is performed, nor are any commands within 
the data executed* 

The <spool> process continues until an end-of-f ile is 

reached. 

If a <spool> command is given while a spool operation is 
currently in progress, an error occurs, but the current 
spooling operation is not disturbed. 

A spooling operation cannot be aborted by pressing the 
CANCEL key on the keyboard. The <stop~spooling> command must 
be used. 

Transfers T© The Host* If the destination device is the host 
computer ( "HO:" ) , then the terminal inserts <EOM- indicators 
into the data being transferred. The <EOM~indicator>s are 
inserted after every N characters of data, where N is the 
maximum line length, set by the <set-report«max-line-length> 
command. (This feature can be disabled by setting the 
maximum line length to zero.) At the end of the data, the 
terminal appends the current <EOF-str ing> , as set by the 
most recent <set-EOF-str ing> command . 

Transfers To Peripheral Ports. If the destination device is 
an RS-232 peripheral port ("PO:" , " P 1 : " , or "P2:") , then the 
terminal appends that port's end-of-f ile string at the end 
of the data being transferred . (This string is determined by 
the <set-port-EOF-string> command . ) 

Transfers to Color Copier* If the destination device is the 
color copier interface ( "HC :" , on a M 1 13) i the source data 
must be in . the format generated by the " SC :" device ( see 
<copy> ) . The "HC :" destination specifier may have an integer 
parameter of zero or one ( "HC:0" , "HC: 1") . For "HC:" and 
"HC :0" , a black screen backround copies as white . For 
"HC : 1 " , a black screen background copies as black . 
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Defaults 



Parameter 

Nunber 

1 

2 
3 



As Shipped 
From Factory 

None 

None 

None 



On Power-Up 

None 
None 
None 



If the Parameter 

is Omitted 

Error JS1 1 
Error JS21 

Error JS3 1 



Errors 



JS01 (Level 2) 

JS03 (Level 2) 

JS10 (Level 2) 

JS1 1 (Level 2) 



JS12 (Level 3) 

JS13 (Level 2) 

JS19 (Level 2) 

JS21 (Level 2) 

JS22 (Level 3) 

JS30 (Level 2) 



Data cannot be fo rmatted for copier by HC : 
(Option 9 only) . 

Command context error ( a spooling operation 
is already in progress) . 

Specified source device does not exist* 

Invalid source specifier (must be "HO: 11 , 
"P0: ,f , 11 P 1 : " , "P2:" , or a file specifier 
such as 11 FO: FILENAME 19 . Specifying only the 
disk drive - such as lf F0: fl or f, F1: ff - is not 
allowed) . 

Parameter 1 memory error (out of memory 
while parsing parameter 1 , or while execut- 
ing the command ) * 

Parameter 3 context error ( not a valid input 
dev ice) • 

Disk hardware error or drive not ready on 
the source disk drive • 

Invalid separator string (must be empty 
string or " TO" ) . 

Parameter 2 memory error (out of memory 
while parsing parameter 2 ) . 

Specified destination dev ice does not ex ist . 
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JS31 (Level 2) 

JS32 (Level 3) 

JS33 (Level 2) 

JS39 (Level 2) 



Invalid destination device specifier* 

Parameter 3 memory error (out of memory 

while parsing parameter 3$ or while execut- 
ing the command) . 

Parameter 3 context error (existing disk 
file is protected ) . 

Disk hardware write protected or drive not 

ready on the destination disk drive. 



References 

<Copy> command* 

<EOF-str ing> syntactic construct . 
<EOM~indicator> syntactic construct . 
<Set-EOF-str ing> command . 
<Set-report-max-line-length> command . 
<Stop-spooling> command . 
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STATUS Command 



There is no escape sequence for the STATUS command. 
This command can only be typed by the operator while 
the terminal is in SETUP mode . 



De script ion 

This command causes the terminal to display the current 
values of many of its settings . For details , see the 
Operator ! s Manual for the par ticul ar terminal . 
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<Stop-Spooling> Command 
SETUP Mode Name: STOP 



SYNTAX 

<stop-spo61ing> = (ESC)(J)(E) 



Description 

The spooling operation currently in progress is aborted . The 
output file is closed . 



Defaults 

Parameter As Shipped On Power-Up If the Parameter 

Number From Factory is Omitted 

None required None required None required 

Errors 

No errors are detected for this command . 

Re f erences 
<Spool> command . 
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<String> Parameter Type 



SYNTAX 




<str ing> = 


= <char- ar r ay> 




= <in t> [ <char> . . . ] . 



Description 

A <string> is just an array of <char>s ; see the description 
of the <array> parameter type for details . 

References 

<Ar r ay> parameter type . 
<Char> parameter type . 
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<Str ing-Report> Syntactic Construct 



SYNTAX 




<str ing-report> = <int+: 

1 / rv Vi o v 1 

L \ cfiar 


number-of-char-reports> 
— r epor l/ • . . j 


<char-arr ay-re port> . 




Description 




A <str ing-report> is just a 
<ar ray-re port> description 


<char-array-report> ; see the 
for details . 


Re f erences 




<Ar r ay-report> 
<Char-repor t> 
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<Terminal-Settings-Report> Message Type 



< term in al- set ting s-report> = 



. 1 



[ <EOM-indicator> ] 
[ <sig-char> ] 
<op-code-repor t> 
[< parameter- re port> 
<eom-indicator> . 



<op-code-repor t> = <char-repor t><char-report> . 

<par ameter-repor t> = <int~report> 

or <real-repor t> 

or <char-report> 

or <xy-report> 

or < int-arr ay-repor t> 

or <str ing-repor t> . 

Note . The optional <EOM-ind icator> at the start of the 
<terminal-settings-report> is only sent if both the 
following conditions are met . Firstly , not terminating 
the current 1 ine with an <EOM-indicator> would cause 
the terminal T s max imum line length to be exceeded * 
Secondly , at least one character must already have 
been sent on the current 1 ine ( that is , since the 1 ast 
<eom~ ind icator> ) . 



Des cription 



The < term inal- setting s- re port> report is sent to the host 
computer in response to a < report- terminal- sett ing s> com- 
mand . 



When the terminal sends a report to the host , bypass mode is 
entered . (See < enter- bypass-mode> . ) 

Optional <EOM-Indicator> . An optional <EOM-indicator> is 
provided at the start of the <terminal-settings-report> 
because of the terminal ' s "maximum line length" feature . 
(See the description of the < se t- r e po rt- max- line- length> 
command for details . ) This <EOM-indicator> is only sent if 
not sending it would cause the terminal's maximum line 
length to be exceeded . 
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Signature Character . The <sig-char> (signature character) is 
sent only if it is not (NUL ) . This character is the current 
<sig-char> for non-GIN reports, as set by the most recent 
< set- re port- si g- char s> command. 

<Op-Code-Report> . Next comes the <op-code-report> , consist- 
ing of of two <char-repor t> s ♦ The two <char>s being reported 
are the same two characters which were used in the < report- 
terminal- setting s> command ; they compr ise either an op code 
for one of the terminal f s command s , or else a spec ial 
inquir y code . 

However , if the <report- terminal- setting s> command specified 
an op code for a command which does not ex ist , or which is 
not installed in the teminal , then the <op-code-repor t> 
consists of two " space" characters : 

<op-code-report> = <char-repor t : (SP)Xchar- report : (SP)> . 

The special inquiry codes are 1 isted in Table 4-20. For each 
inquiry code , the table al so shows the <par ameter-repor t> s 
which are includ ed in that inquiry code 1 s < terminal- set- 
tings-repor t> . 
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Table 4-20 
SPECIAL INQUIRY CODES 



Code 


Associated <Parameter-Report>s' 


?M 


< int-repor t : av ail able- memory > 

< in t-report : 1 argest-contiguous-block> 




(The available memory, and the size of the 
largest contiguous block, are reported as a 
number of 16-byte units of memory .) 


?T 


<int-report : mod el- number- cod e> 




(For the 4112, the model number code is 4112; 
for the 4114, the code is 4114.) 


00 


<in t- report : stand ard- f irmwa re- ver sion- number > 


01 to 99 


<in t- report : optional- firmware- ver sion- number > 
(If a firmware option is not installed, the 
version number reported is zero . ) Option 20 ( in 
a 4112) and Option 2 1 ( in a 4113) are hardware 
options ; the terminal returns " 1 " if the option 
is installed , or "0 " if the option is not 
installed . 
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<Par ameter-Report> . The command specified by op code in the 
<op-code-repor t> has in its syntax a number of parameters. 
The current values of these parameters are returned, in 
order, in the <parameter-report>s . 

Each < par ameter-repor t> is of an appropriate type for the 
parameter being reported. For instance, consider a 
< term in al- set tings- report> for the terminal's baud rate. The 
< set-baud-r ate> command (op code NR) has two parameters of 
type < int+ > . The terminal sends the values of < int+> parame- 
ters to the host using the < int-repor t> syntax. Therefore, 
in the corresponding < terminal-settings-report> , there are 
two <parameter-report>s, each being an < int-repor t> . 

For the special inquiry codes, the < par ameter-repor t> are 
those listed earlier, in Table 4-20. 

(For syntax details, see the descriptions elsewhere in this 
section of <char-report> , < in t-repor t> , <real-repor t> , etc.) 
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Exampl es 

Reporting the baud rates. The <re port- terminal-settings : 
(N ) , (R )> command requests the terminal to send a report of 
its current baud rate settings . (This is because it is the 
< set- baud- rate s> command which has the op code NR.) 

Assume that the terminal is not in block mode , that its 
current <EOL-str ing> is the single character , ( CR ) , and that 
the < sig-char> for non-GIN reports is (A). Assume also that 
the terminal is set to transmit and receive at 1200 baud . In 
that case , the report which the terminal send s to the host 
is : 

<terminal-settings-repor t> = [ <E0M-ind ic ator> ] (usually omitted) 

< sig-char> 
<op-code-repor t> 

<parameter- report : f ir st- baud- rate> 
< parameter- report : second- baud- rate> 
<E0M-ind icator> 

= (A) 
(N)(R) 

<int-report : 1200> 
<int-report : 1200> 
(CR) 

= (A)(N)(R)(!)(+)(0)(!)(+)(0)(CR) . 
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Reporting the Amount of Available Memory. To request a 
report on the amount available memory, the host sends a 
< report- terminal- setting s : (?)(M)> command. If the < sig- 
char> and <EOL-str ing> are as in the previous example, and 
that the terminal is not in block mode, then the report 
which the terminal sends the host is as follows: 



<terminal-settings-report> = [ <EOM-ind icator> ] (usually omitted) 

< sig- char> 
<op-code-repor t> 

<par am eter- report : available-memory> 
<par am eter- report : largest-block> 
<eom-indicator> 



= (A) 
(?)(M) 

< int-report : a v ai 1 able- memory > 
<int-report: largest- block> 
(CR) . 



Exceptions 

For a few commands (op codes) the meanings of the parameters 
reported in the < terminal- setting s-report> differ from the 
meanings of the parameters when sending those commands to 
the terminal. These commands are: 



<lock-viewing-keys> (op code RJ) 

< set- sur f ace-gr aylev el s> (op code RG) 

<set-sur face-colors> (op code TG) 
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<Lock-Viewing-Keys> . The <loek-viewing-keys> command exists 
in the 4112 and 4113 terminals, but not in the 4114 
terminal . This command takes the form (ESC) (R ) ( J XintX. 
Therefore, a <report-terminal-settings : ( R ) , (J)> command 
causes the terminal to send a < terminal-settings-repor t> 
which has one < par ameter- repor t> , of the < int-repor t> type : 



< terminal- sett ing s-report> 



= [<EOM-indicator>] 
[ <sig-char> ] 
(R)(J) 

< int-report : v iewing-key~status > 
<EOM-indicator> . 



In this report , however , the "viewing key status" integer 
can assume more values than just zero and one . It can assume 
values from zero to three . The meanings of these are as 
follows : 

The terminal is in not in fr aming mode . 
(That is , it is neither in ZOOM mode nor in 
PAN mode . ) Moreover , the v iewing keys are 
not locked . (This does not pr eclud e the 
entire keyboard 1 s being locked as a result 
of a < lock-keyboard> command.) 

1 The terminal is in ZOOM mode . 

2 The terminal is in PAN mode. 

3 The viewing keys are locked . (Therefore , 
the terminal is neither in ZOOM mode nor in 
PAN mode. ) 
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<Set-Surface-Gr ay-Lev el s> Command • The <set- sur f ace- gray- 
levels> exists in the 4112 and 4113 terminals, but not in 
the 4114. This command has the syntax (ESC) (R ) (G XintXint- 
arr ay> . Therefore, a <report- terminal -set tings : (R),(G)> 
causes the terminal to send a < terminal- setting s- report> 
message which has two <par ameter-repor t> s , of the < int- 
repor t> and < in t-ar ray-re port> type s . However , the meanings 
of these <parameter-reports> differ from those of the cor- 
respond ing parameters in the <set-sur face- gray- lev el s> com- 
mand : 

<terminal-se tting s-repor t> 
= [<EOM-indicator>] 
t <sig-char> ] 
(R)(G) 

<in t-report : n umber- of- sur f ace s> 

< in t-ar ray- re port : gray-levels- for- sur f aces ) 

<EOM-ind icator> . 

In this <term inal- settings- re port>, the < int-repor t> tells 
how many sur faces are defined . 

The < in t-ar ray-re port> contains sur face number s ( expressed 
as negative integers) , followed by the gray-levels for each 
surface ( expressed as positive integers) . Consider , for 
instance , the following < in t- arr ay-report> : 

<int-array-report : (-1, 90, -2 , 30, 60, 90)> 

This is interpreted as meaning that sur face one has color- 
index one set to 90% lightness , while sur face two has color- 
index one set to 30%, color- index two set to 60%, and color- 
index three set to 90%. (Since color-index zero always means 
" transparent , " no gray-level is reported for color- index 
zero . 
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The number of gray-levels reported for each surface is one 
less than two to the power N , where N is the number of bit 
planes assigned to that surface. Thus , a surface with one 
bit plane has* one gray-level reported, while a surface with 
two bit planes has three gray-levels reported. If a surface 
has zero bit planes, then no gray-levels are reported for 
it. Consider, for instance, the following < int- array-re- 
port : 

< int- array-report: (-1,-2,10, 1 5 , 30 , 45 , 55 , 70 , 90 ) > 

This would be interpreted to mean that sur face one has no 
bit pi anes ( and therefore no gray-levels to report) , while 
surface two has three bit pi anes . The gray-level for the 
color- index one on sur face two is 10%, that for color- index 
two on surface two is 15%, and so on . 

<Set-Sur face-Color-Ma p> Command . The < set-sur face- color- map> 
command ex ists in the 4113 terminal , but not in the 4112 or 
the 4114. This command has the syntax (ESC) (T ) (G XintXint- 
array> . Therefore, a < report- terminal- sett ings : (T ) (G )> com- 
mand causes the terminal to send to the host a < terminal- 
settings- re port> with the following syntax : 

< terminal- set tings-report> 
= [<EOM-indicator>] 
[ <sig-char> ] 
(T)(G) 

< int-repor t : number- of- sur f aces > 
<int- array-re port: color- info> 

<EOM-indicator> . 



4-590 



rev,deci98i 4110 SERIES COMMAND REFERENCE 



ALPHABETICAL LISTING 



Here, the < int-report> tells the number of surfaces current- 
ly defined, while the < in t- arr ay-repor t> contains 
information about the background color mixture, and about 
the color mixtures f or each of the color- ind ices on each of 
the sur faces . (This is d if f er en t from the meanings of these 
parameters when send ing a < set- sur f ace- col or- map> command 
from the host to the terminal . ) 



The details of the < int-arr ay-repor t> are as follows : 



<int- array-report: color- info > 



= <int-repor t : number- of- in t- reports- to- follow > 
< triple-report : background- col or > 
[< co 1 or s-f or- on e- s ur f ac e> . . . ] . 



<color s- for-one- sur f ace> 



<int-report: negative- sur f ace- number > 

[ <tr iple-report : three- color- coord inates> . . . 3 . 



< triple- re port> = <HLS-tr iple-repor t> 

or <RGB-tr ipl e-repor t> 
or <CMY-tr iple-repor t> . 



<HLS-tr iple-repor t> = 



<RGB-triple-report> = 



<in t-repor t : 
< int-repor t : 
<int-report ; 

<int-repor t : 
<int-report ; 
< int-repor t : 



hue- angle- in-degrees> 
1 ightness-percentage> 
satur ation-percentage> 

r ed-percen tage> 
green-percen tage> 
blue-percen tage> . 



<CMY-tr iple-repor t> = 



<in t-repor t ; 
<int-report : 
< int-repor t ; 



cyan-percentage > 
magenta- per cenTsage > 
blue-percen tag e> . 



The HLS, RGB , or CMY color coord inate system is used in the 
report , depend ing on which color specifying mode was select- 
ed by the most recent < set-color-mode> command . 

Suppose , for instance , that HLS color coord inates are being 
used . (This is the defaul t when the terminal is turned on . ) 
Consider the following < in t- arr ay-repor t> : 
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<int- array-re port: color- info> 



<int- 
<int- 
<int- 
■<int- 
<int- 
<int- 
<int- 
<int- 
<int- 
<int- 
< irrt- 
<int- 
<int- 
<int- 
<in t- 
<int- 
<int- 
<int- 



report 
report 
report 
report 
report 
report 
report 
report 
report 
report 
report 
report 
report 
report 
report 
report 
report 
report 



17> 

0> 
0> 
0> 
-1> 

120> 

50> 

100> 

-2> 

180> 

50> 

100> 

240> 

50> 

100> 

0> 

100> 
0> . 



Here , the first < int-report> says that there are 17 <int- 
repor t> s to follow in the < int-arr ay-report> . 

The next three < int-report> s say that the background color 
is black ( hue 30 degrees ; 1 ightness zero , satur at ion zero) . 

The following four <int-report>s carry the numbers - 1 , 120, 
50 , 100. Thus , on surface one , color- index one is d ispl ayed 
as a red color ( hue 120 degrees , 1 ightness 50%, saturation 
1 00% ) . Since only one set of three coord inates follows the - 
1 , there must be only one non-zero color-index for that 
sur f ace . In other words , sur face one has only one bit pi ane 
assigned to it . 

Likewi se , the next ten < int-report> s c arr y the numbers -2 , 
180, 50, 100, 240, 50, 100, 0, 100, 0. These give three sets 
of color coord inates for sur face number two . On that sur- 
face , color- index one is displayed as yellow ( hue 1 80 , 
1 ightness 50 , saturation 100) , color index two as green ( hue 
240 , lightness 50, satur ation 1 00 ) , and color index three as 
white ( hue , 1 ightness 1 00 , satur ation ) . Since three sets 
of color coord inates are reported for sur face two , that 
sur face must have two bit pi anes assigned to it . 
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<Se t- Vie w-Di spl ay-Cluster > Command. The command exists only 
in the 4113 terminal . 

This command has the syntax (ESC) (R)(Q)<int-array>. There- 
fore, the command ? 

< report- terminal- setting s : (R)(Q)> 

= (ESC)(I)(Q)(R)(Q), 

causes the terminal to send to the host a < terminal- 
setting s- re port> with the following syntax : 

<terminal- set tings- report> = [ <EOM- indicator > ] 

[ <sig-char> ] 

(R)(Q) 

< in t- ar ray-re port> 
<EOM-indicator> . 

Here , the < in t- ar r ay-repor t> tells how views are grouped 
into view d ispl ay clusters . For the purposes of this report , 
the clusters are assigned numbers . The first number in the 
< in t-arr ay-repor t> tells to which cluster , if any , view 
number one is assigned . Likewi se , the second number in the 
array tells to which cluster view two is assigned , - and so 
on . If a view has not been assigned to any d ispl ay cluster , 
then n cluster number zero" is reported for that view . 

Suppo se , for instance , that the signature character for non- 
GIN reports is the tilde ( ~ ) , and that the host has issued 
the character sequence , (ESC) (I ) (Q ) (R ) (Q ) . (This is a 
< report- terminal- setting s> command which inquires about the 
view d ispl ay cluster settings . ) One po ssible response from 
the terminal would be : 

(~)(R)(Q)(SP)(SP)(6)(SP)(SP)(1 )(SP)(SP)(1 ) 
(SP)(SP) (1 )(SP)(SP)(0)(SP)(SP)(2)(SP)(SP)(2)(CR) . 
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Here , the tilde ( ~ ) is the <sig-char> , the characters ( R ) (Q ) 
signify that the report is for the RQ op code , and the final 
(CR) is the <EOM-ind icator> . The other characters comprise 
an < in t-array-repor t> , as follows: 



(SP) (SP) (6 ) 
(SP)(SP)(1 ) 
(SP)(SP)(1 ) 
(SP)(SP)(1 ) 
(SP)(SP)(0) 

(SP)(SP)(2) 

(SP)(SP)(2) 



<int-report: 6> 

<int-repor t : 1 > 

<int~report : 1 > 

<int~repor t : 1 > 

<int~report : 0> 

< in t- re port : 2> 

<in t-repor t : 2> 



The array has six items . 

View 1 is in display cluster 1 

View 2 is in display cluster 1 

View 3 is in display cluster 1 

View 4 is not in any display 
cluster . 

View 5 is in display cluster 2 

View 6 is in display cluster 2 



Thus , the <terminal-settings-report> tells the host these 
things: 

The highest-numbered view which is in a view display 
cluster is view number six. 

Views one ? two , and three are in the same display 
cluster . . 

Views five and six are in the same display cluster . 
View four is not in any view display cluster. 



References 



<Ar r ay-report> 
<Char-repor t> 
<In t-report> 

command . 
<Real- repor t> 

<Report-terminal-settings> command . 

command . 

<Se t- sur face- gray- lev el s> command . 
<Set-view-display-cluster> command . 
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(US) Character 

See the description of the < enter- alpha-mode> command. 
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VIEW Key 41 12, 4113 



The VIEW key exists only in the 4112 and 4113 terminals. It 
does not auto-repeat . 

Pressing the VIEW key causes the current viewport to be 
wiped , the window for the current view to be defined 
according to the current framing box for that view , and the 
view to be redrawn using the new window-viewport transform . 
(The "framing box" is a "proposed new window" which the 
operator defines using the PAN and ZOOM keys . This "proposed 
new window" takes effect when the operator presses the VIEW 
key,) 

When the operator presses the VIEW key , the old value of the 
framing box becomes the new values for both the window and 
the framing box . The terminal remembers the old window and 
old fr aming box by s tor ing them in a memory stack , whose 
stack depth never exceeds three . (These old values may be 
recov ered by pressing the RESTOR key . ) 

BCTRL-VIEW. Pressing CTRL-VIEW (pressing the VIEW key while 
holding down the CTRL key) causes the following to occur : 



1 . The next higher-numbered view is selected . 

2. The VIEW f unction is performed on that view . 

3 . The or ig inal view is selected again . 

In other words , pressing CTRL-VIEW is equivalent to pressing 
the following keys: NEXTVIEW, VIEW, CTRL-NEXT VIEW . 

If the same segments are visible in both views, the CTRL- 
VIEW feature make s it easy to use one v iewpor t to show an 
enl argement of part of the picture shown in the other 
v iewport . 
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Effect On Other Views in the Same View Display Cluster. In 
the 4113 terminal, views may be grouped into "view display 
clusters. 11 (See the < set- v iew-d ispl ay- cluster > command for 
details.) If the current view belongs to a view display 
cluster , and the VIEW ( or CTRL-VIEW) key is pressed , then 
the VIEW (or CTRL-VIEW) key affects not only the current 
view, but also all other views in that cluster. That is, all 
v iews in the cluster have their windows upd ated to match the 
current f r aming box , and all v iews in the cluster have their 
v iewpor ts erased and red rawn . 



Re f erences 

PAN key. 

RESTORE key. 
command . 
ZOOM key. 
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(VT) Character 



Description . 

Alpha mode . When the terminal is in alpha mode, the ASCII 

(VT) character ("vertical tab" character) causes the alpha 

cursor to move up one line. If already at the top, no action 

occurs. If the dialog area is present, no action occurs. 

Vector and marker modes • When the terminal is in vector mode 
or marker mode, the (VT) character has no effect. 



Re f erences 

<En ter- alpha- mod e> command . 
<En ter- vec tor-mode> command * 
<En ter-marker-mode> command . 
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<XY> Parameter Type 



SYNTAX 




The following summarizes the formal syntax of < xy> 
coordinates: 


<xy> = 


[ <Hi Y> ] [ [<Extra>] <LoY> [<HiX>] ] <LoX> 


<Hi Y> = 


an ASCII character with high-order bits "01" - 
a character in the "numbers and s vm bo 1 s " on 1 um n 
of the ASCII chart. 


<Ex tr a> 


= an ASCII character with high-order bits "11" - 
a character in the " lowercase" column of the 
ASCII chart. 


<LoY> = 


an ASCII character with high-order bits "11" - 
a char ac te in the " lowercase" column of the 
ASCII chart . 


<HiX> = 


an ASCII character with high-order bits "01" - 
a character in the "numbers and symbols" column 

of the ASCII chart. 


<LoX> = 


an ASCII character with high-order bits "10" - 
a character in the "uppercase" column of the 
ASCII chart. 


Syntax Graph 


The above 
understand 
graph . 


syntax is a 1 ittle tr icky ; to be sure you 
it , it is repeated in Figure 4-23 as a syntax 
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12566-4 

Figure 4-23. <XY> Parameter Syntax . 



<xy: (52,1 000) > 



x -coordinate = decimal 52 
= binary 00000 01101 00 



y -coordinate = decimal 1000 

= binary 00VU WOW 00, 



<HiY> 



<Extra> 



01 



00111 



= (') 



11 





00 


00 



= ( ) 



<LoY> = 



11 



r 



11010 



<HiX> = 



01 



00000 



<LoX> = 



10 



01101 



= (z) 



= (SP) 



= (M) 



<xy: (52,1 000) > = (')( )(z)(SP)(M) 



12566-5 



Figure 4-24, Format of <XY> Bytes. 
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Description 

To send a pair of x- and y-coord inates to the terminal, you 
must encode them in a certain way. In this manual, the term 
< xy> refers to a pair of x- and y-coord inates as encoded for 
transmission to the terminal. The term <xy : ( 1 00, 200)> would 
refer to the coordinate pair (100,200), as encoded for 
transmission to the terminal. 



Format of <XY> Coordinate Bytes 

Each <xy> parameter consists of from one to five ASCII 
characters (seven-bit bytes). The bytes are sent in this 
order : <Hi Y> <Extra> <LoY> <HiX> <LoX>. Figure 4-24 shows 
the formats of the five bytes . 



Order and Meaning of the <XY> Characters 



1 . The <HiY> (high-order y) character comes first . This 
character contains the most- signific ant five bits of 
the binary numeral representing the y-coordinate . The 
seven bit ASCII character ( exclud ing the eighth , or 
parity bit) has this format : 

1 y y y y y 

yyyyy : high-order five bits of the y-coordinate . 

You can omit the <Hi Y> byte if the high-order five 
bits of the y-coordinate hav e not changed since the 
last <xy> coord intate sent to the terminal . 



4110 SERIES COMMAND REFERENCE 



4-601 



ALPHABETICAL LISTING 



2* Next comes the <Extra> character. This character 

contains the margin bit , the least-significant two 
bits of the x-coordinate , and the least-significant 
two bits of the y-coordinate . 

1 1 m y y x x 

m : margin bit 

yy : leasts-significant bits of y-coordinate 
xx : least-significant bits of x-coordinate 

You can omit the <Ex tra> character if the least- 
significant bits of the x- and y-coordinates have not 
changed since the last <xy> coordinate sent to the 
terminal* If you do send the <Extra> character , you 
must follow it with the <LoY> character . Whenever an 
<Ex tra> byte with its margin bit set to zero is 
received by a 4114, the current margin is reset to 
margin one (X = ) . 

3. Next comes the <LoY> ( low-order y) character . Despite 
its name , this character contains the in termed iate 
five bits of the 12-bit y-coordinate . 

1 1 y y y y y 

yyyyy : intermediate five bits of y-coordinate . 

You c an omit the <LoY> character prov ided : ( a) you are 
sending neither the <Ex tra> character nor the <HiX> 
character in this <xy> coord inate , and (b) the inter- 
mediate five bits of the y-coordinate have not changed 
since the last <xy> coordinate sent to the terminal . 

4. Next comes the <HiX> (high-order x ) character . This 
character contains the high-order ( most-significant) 
five bits of the x-coord inate . 

1 x x x x x 

xxxxx : most- significant five bits of x-coordinate . 

You can omit the <HiX> character if the x-coord inate T s 
most-significant bits have not changed since the last 
<xy> parameter sent to the terminal . If you do send 
the <HiX> character , then you must precede it with the 

<LoY> byte. 
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5 . Finally comes the <LoX> (low-order x) character, 

Ag ain , despite its name, this character contains the 
intermediate five bits of the x-coord inate . This char- 
acter is always required, because it serves to termi- 
nate the <xy> parameter sequence. 

NOTE 



The <LoY> and <Ex tra> bytes each have 
high-order bits of 11. Thus the (DEL) 
character (binary 1111111) is a possible 
<LoY> or <Extra> byte* Since some host 
computers use (DEL) as a filler 
character f this could be a problem in 
some installations . 

The 4110 terminals include two features 
which together provide a way to overcome 
this difficulty* First , the terminal 
treats (ESC) ( ?) as a synonym for the 
(DEL) character* Secondly , it can be set 
to ignore (DEL) characters. (Use the 
<ignore«-deletes> command . ) 

If your host computer uses (DEL) as a 
filler character, then you should use 
these features . Have the host send 
(ESC) (?) in place of (DEL) in <xy> par- 
ameters , and send an < ignore- del etes> 
command to the terminal • 



Re f erences 

<Ignor ed-del ete s> command . 
<XY-repor t> parameter type . 
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<XY-Report> Parameter Type 



SYNTAX 

<xy-repor t> = [<eom-indicator> ] 
<char: Hi Y-repor t> 
<char : Ex tr a-repor t> 
<char : LoY-repor t> 
<char : HiX-repor t> 
<char: LoX-repor t> . 

PARTS OF THE REPORT 

<EOM-Indicator> . The <EOM-ind icator> is rarely includ- 
ed in the < xy-repor t> . The terminal only send s this 
<EOM-ind icator> if there is no other way to avoid 
exceeding the current max imum report 1 ine length . 

<HiY-report> , <Ex tra-report> ? <LoY«-report> , <HiX-re- 
port> and <LoX-report> . These are all ASCII characters 
with high-order bits "01" - characters in the "numbers 
and symbols" column of the ASCII chart . They 
correspond to the bytes wi thin an < xy> parameter sent 
to the terminal , but occupy d if f erent columns of the 
ASCII chart. 



Description 

When the terminal reports an xy-coordinate to the ho st 
computer , it send s that information using the < xy-repor t> 
syntax . The < xy-repor t> s (which the terminal send s to the 
host) resemble , but differ slightly from , the <xy> parame- 
ters (which the ho st send s to the terminal . 

The d if ferences are these : 

Under certain c ir cumstances an <EOM-indicator> may 
precede the data bytes . 

All five data bytes are always sent . 
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All five data bytes have the most- sign if ic an t two bits 
of their seven data bits set to "01. " (However, their 
significant five bits have identical meanings to the 
least-significant five bits in the corresponding char- 
acters of the <xy> parameter type.) 

<EOM-Indicator> . The optional <EOM-indicator> , if sent 
in the < xy-repor t> , will always be the terminal ? s 
current <E0L-str ing> . This <E0M- ind ic ator > is rarely 
sent . The reason for this is that an < xy-repor t> is 
always part of some larger report message , and the 
syntax of that 1 arger report generally makes pr ov ision 
( with its own <E0M-ind icator> s) for terminating lines 
before the max imum line length is exceeded . 

However , if the max imum report 1 ine length is set too 
short , then it is possible that the optional <E0M- 
indicator>s in the syn tax of the larger report would 
not c ause the 1 ine to terminate soon enough . Only in 
that case would the optional <E0M-ind icator> in the 
< xy-repor t> syntax come into pi ay . 

The optional <E0M-ind icator> is includ ed in an < xy- 
repor t> when all the following cond itions are met : 

The terminal is not in block mode . 

At least one character has already been sent on the 
current 1 ine ( that is , since the last <E0M-char> or 
<E0M-indicator> ) . 

If the <EOM-indicator> were not to be sent , send ing 
the the five data bytes would cause the current 
max imum report 1 ine length to be exceeded . 

Parsing an <Xy~report> . A general-purpose routine for pars- 
ing <xy-report>s should take into account the optional <eom- 
ind icator> . 

Since this <E0M-ind icator> is only sent if the terminal is 
not in block mode , and since in that c ase the <E0M- 
ind icator> is just the current <E0L-str ing> , the parsing 
routine should be able to distinguish the current <E0L- 
string> from val id <Hi Y-repor t> , <Ex tra-report> , <LoY- 
repor t> , <Hi X-repor t> , and <LoX-repor t> data bytes . 
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The best way to do this is to choose an <EOL~str ing> which 
consists only of control characters , such as ( CR ) and (LF) . 
In that case ? the parsing routine can just skip over any 
such control characters . 

(For examples of this principle, see < int-repor t> and <char- 
repor t> . ) 



References 

<Char-report> parameter type . 
<EOM-ind icator> syntactic construct . 
<In t-repor t> parameter type • 
<Se t- max- report- line- length> command . 
<XY> parameter type . 
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ZOOM Key 4112, 4113 



Description 

The ZOOM key exists only in the 4112 and 4113 terminals. It 
does not auto-repeat . 

Entering ZOOM Mode . Pressing the ZOOM key while the 1 ight in 
the key is off puts the terminal in 11 framing mode , " in the 
"ZOOM submode , n and turns on the 1 ight in the key . A 
"framing box" appears on the screen , showing the boundaries 
of a " pr opo sed new window. " 

The Fr aming Box . The framing box is a rectangle with a 
device in the center to ind icate size and submode . This 
dev ice consists of two corners of a rectangle which is one- 
six teenth as 1 arge as the framing box , and is centered on 
the center of the fr aming box . 

Changing the Si ze of the Framing Box . While the light in the 
ZOOM key is on , moving the thumbwheel s c ause s the si ze of 
the fr aming box to change . The fr aming box is only a 
pr opo sed new window; that window does not take effect until 
the operator presses the VIEW key . 

Mov ing either thumbwheel causes the box to grow or shr ink 
evenly in both axes. Pressing SHIFT whil e mov ing the 
thumbwheel s causes the box to grow or shr ink more slowl y ; 
this is convenient for fine ad j ustment of the fr aming box 
si ze . 

Changing the Shape of the Framing Box . Pressing CTRL while 
mov ing a thumbwheel causes only one d imension of the framing 
box to change . ( For instance , pressing CTRL and mov ing the 
v er tic al thumbwheel changes the height of the framing box , 
but does not change the width.) This lets the operator 
change the shape of the frame . (The operator can restore the 
" normal shape" - the same ratio of wid th to height as for 
the current view's v iewpor t - by pressing the NORMAL key . ) 
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Minimum Size of Framing Box. The operator cannot , by moving 
the thumbwheels in ZOOM mode, make the framing box less than 
one sixteenth the si ze of the current window. (To " zoom in 11 
fur ther than that , the operator must first press the VIEW 
key , updating the window . The operator can then continue to 
"zoom in", down to one-sixteenth the si ze of that window. ) 

The operator cannot , by mov ing the thumbwheel s in ZOOM mode , 
make the the framing box less than eight units wide or eight 
un its high in 4096-by-4096 terminal space . Nor is it desira- 
ble to zoom in to create that small a window. ( At such small 
window sizes, the "granularity" of the 4096~by~4096 terminal 
space causes 1 ines not to be d ispl ayed accurately . ) 

Ex iting ZOOM Mode . The operator can remove the terminal from 
ZOOM mode in two ways : 

Pressing the PAN key leaves the terminal in " framing 
mode , " but transfers it from the ZOOM submode to the 
PAN submode . The 1 ight in the ZOOM key goes out , while 
the 1 ight in the PAN key turns on . The dev ice in the 
center of the fr am ing box changes to a cross . 

Pressing the ZOOM key removes the terminal both from 
framing mode and from the ZOOM submode . The 1 ight in 

the ZOOM key turns off. 

CTRL-ZOOM Key. If the terminal is in either "zoom" or "pan" 
mode (that is , if either the ZOOM or PAN light is on) , then 
pressing CTRL-ZOOM produces a fixed zoom of the viewport . 
That is , pressing the ZOOM key while holding down the CTRL 
key is equivalent to enter ing " zoom" mode ( if not already in 
that mode) , moving the thumbwheels to make the framing box 
smaller , and then pressing the VIEW key . 

In the 4113, views may be grouped into "view d ispl ay 
clusters." ( See the <set-view-display-cluster> command for 
details . ) If the current view belongs to a view d ispl ay 
cluster , then pressing CTRL-ZOOM affects not only the cur- 
rent view, but al so all other v iews in that d ispl ay cluster . 
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References 

NORMAL key. 

PAN key. 

VIEW key. 

OVERVIEW key. 

<Se t-window> command . 
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<4010-GIN-Report> Syntactic Construct 



SYNTAX 

<4010-GIN-report> = <ASCII-char : key-pressed> 

<401 0-xy-report> 
<EOM-indicator> . 

<4 1 0-xy-report> = <HiX-repor t> 

<LoX-repor t> 
<Hi Y-repor t> 
<Lo Y~repor t> • 

PARTS OF THE REPORT 

Key-Pressed . A single ASCII character , correspond ing 
to the key which the operator pressed to initiate the 
<4010-GIN-report>. 

<4010-XY-Report>. Tells the location of the GIN cursor 
when the operator pressed a key to initiate the GIN 
report . The position is reported in the format used by 
401 0-ser ies TEKTRONIX terminals ; consequently , the po- 
sition is reported only to a precision of ten ( rather 
than 12) binary bits . 

<HiX-Report>, <LoX-Report> , <HiY-Report> , <LoY- 
Report> . These are all seven-bit ASCII characters with 
high-order bits "01" - characters in the " letters and 
" f igures" column of the ASCII chart . 



Description 

When the 4110 respond s to an <en able- 401 0-GIN> command - the 
sequence of characters (ESC) (SUB) - it is emul ating a 
TEKTRONIX 4010 Series computer display terminal . Therefore , 
it sends coord inate information to the host computer using 
the <401 0-GIN-report> syntax rather than the <GIN-report- 
sequence> syntax that it uses when respond ing to the <en- 
able-GIN> command . 

When the terminal send s a report to the host , bypass mode is 
entered . (See < enter- bypass- mod e> . ) 
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<ASCII~char> parameter. The first part of the <4010-GIN- 

r epor t> is a single ASCII character . This is the character 
for the key which the operator pressed to initiate the GIN 
report, (After the <en able- 4010 -GIN> command , the terminal 
d ispl ays the graphic s cur sor . The operator positions the 
graphics cur sor using the thumbwheel s , and then pr esse s a 
keyboard key to initiate the <401 0-GIN-report> . The <ASCII- 
char> parameter in the <4010-GIN-report> is the ASCII char- 
ac ter correspond ing to the key which the operator pressed . ) 

<4 01 0-xy-repor t> parameter . The second part of the <401 0- 
GIN-report> is the <401 0-xy-repor t> . This consists of four 
ASCII characters , correspond ing to the <HiX> , <LoX> , <Hi Y> , 
and <LoY> characters in the <xy> parameters which the host 
may send to the terminal when d ispl aying graphics on the 
terminal 1 s screen . However , these characters d if fer from 
those in the < xy> syntax , in that their high-order bits 
( "tag bits" ) are always "01," pi ac ing them all in the 
11 numbers and symbols" column of the ASCII chart . 

Al so , the characters in the <40 1 0-xy-repor t> are sent in the 
order <HiXXLoXXHi YXLoY> . This is different from the order 
used in <xy> parameters . It is al so different from the order 
used in < xy-repor t> s sent as part of <GIN-repor t-sequence> s 
in response to the < enable-GIN> command . 

<EOM-Indicator> . The <E0M-ind ic ator> ( "end -of- message" ind i- 
cator ) marks the end of the report, If the terminal is not 
in block mode , this is j ust the current <E0L-str ing> , as set 
by the most recent < se t-EOL-str ing> command . Typically , this 
is just the "carriage return" character , (CR) . For more 
details^ see the description of the <E0M-ind icator> 
syn tac tic construct and the < set-EOL-str ing> command . 

To most closely emul ate the 4010 Series terminal s , the 
terminal should not be in block mode . The <E0L-str ing> 
should be set ( by a < set-EOL-str ing> command , as in Table 4- 
21 . 
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Table 4-21 

<EOL-STRING> SETTINGS TO EMULATE 4010 SERIES TERMINALS 



GIN Strap 


<EOL-string> 


(in 4010 Terminal) 


(in 4110 Terminal) 


CR and EOT 


(CR) (EOT) 


CR only 


(CR) 


no CR, no EOT 


empty string 



Re ferences 



<Enable-4010-GIN> command . 

<EOM-ind icator> syntactic construe t . 

<Se t-report-EOM-frequency> command . 

<Set-EOL-string> command . 

<Xy> parameter type, 

<Xy-repor t> syntactic construct. 
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<4010«H&rdeopy> Command 



SYNTAX 

<M010-hardcopy> = (ESC) (ETB) . 



Description 

The <40 10-hardcopy> command is provided for compatibility 
with host software written for use with earlie~ TEKTRONIX 
terminals • This command has the same effect as pressing the 
HARDCOPY key . A hard copy of the display is made on the hard 
copy unit ( provided one is attached ) . 

Issuing the <4010-hardcopy> command is equivalent to issuing 
the <hardcopy> command with a parameter of zero : 

<hardcopy: 0> s (ESC) (K) (H) (0) . 



If Option 9 is installed 9 this command causes a hard copy of 
the display to be sent to the interface selected with the 
<select-hardcopy-interf ace> command . 



References 

<Hardcopy> command . 
HARDCOPY key. 

<Select-hardcopy-interf ace> command 
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<J|010~Status«»Report> Message Type 



SYNTAX 

<4 010-status-report> = <40 10-GIN-status-report> 

or <4010-non-GIN-status-re- 

port> • 

<4010-GIN-status-report> = <4010-xy-report> 

<eom-indicator> . 

<4 010-non~GIN-status-report> z <4010-status-byte> 

<4010-xy-report> 

<eom-indicator> . 

<4 010-status-byte> = a seven-bit ASCII character whose 

high-order two bits are 11 1 11 and 
whose least- significant five bits 
hold status information , de- 
scribed below* 

<4010-xy-report> s <HiX-report> 

<LoX-report> 
<HiY-report> 
<LoY-report> . 

PARTS OF THE REPORT 

<4010«GXN-StatU3-»Report> . If the terminal is enabled 

for graphic input , the report message does not include 
a <4010-status-byte> . 

<4010»nofi»GIN»Status-Rtport> . If the terminal is not 
enabled for graphic input , the report message begins 
with a <4 010-status-byte> . 

<l|010~StatU3~Byte> . A seven-bit ASCII character , in 

the range from (SP) to (?) - a character whose two 
high-order bits are ff 01 ts * The least-signicant five 
bits hold status information . 

<4010-XY-Rtport>. Four ASCII characters holding 10-bit 
x- and y-coordinates for the location of the termi- 
nal 1 s cursor. 
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Description 

The <4010~status-report> is sent by the 4110 in response to 
a <report-4010-status> command (the (ESC) (ENQ) sequence). It 
may also be sent if the terminal has received a <enable- 
4953-tablet-GIN> command and the operator moves the peri (or 
four-button cursor) away from the tablet surface. 

When the terminal sends a report to the host, it enters 
bypass mode. (See the < enter-by pass-mod e> command.) 

Itsponding to a <Ieport-ifei0-Siafeys> Comnand • If the 

terminal is responding to an (ESC) (ENQ) sequence, it sends 
to the host either a <4010«~GIN-status-report> or a <4Q10- 
non-GIN-status-report> f depending on whether or not it has 
been enabled for graphic input. 

If enabled for graphic input (with an <enable-401 0-GIN> or 
<enable-GIN> command) f the terminal responds to the 
(ESC) (ENQ) by sending a <4010-GIN-status-report> • This con- 
sists of four ASCII characters comprising a <4010-xy-re- 
port> , followed optionally by an <EOM-indicator> . The <4010- 
xy-report> holds 10-bit x- and y-coordinates for the current 
position of the graphic cursor . 

If not enabled for graphic input , the terminal responds to 
an (ESC) (ENQ) sequence by sending a <4010-non- r T h-status- 
report> . This report is similar to the <4010-GIN-status- 
report> , but with two differences . First , the report begins 
with a <4010-status-byte> which holds status info rmation 
about the terminal . Second , the <4010-xy-report> gives the 
position , not of the graphic cursor , but of the terminal 1 s 
alpha cursor . 

Ten-Bit Precision e The <4010-xy-report> gives the coordi- 
nates of some point in 4096-by-4096 terminal space, but it 
gives those coordinates with only ten-bit precision . That 
is , only the most significant ten bits of the x- and y- 
coordinates are sent to the host ; the least significant two 
bits of those coordinates are omitted . Consequently , there 
may be an error of up to three terminal space units in the 
position that is reported to the host computer . 

If full twelve-bit precision is required , the <enable-GIN> 
or <report-GIN-point> command should be used , rather than 
the <enable-4010-GIN> or <report-4010-status> command . 
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<4010-St«tus-Byte> • The <4 010-status-byte> is a seven-bit 

ASCII character* Its two most-significant bits are "01", and 
its least-significant bits hold status information about the 
terminal, as follows: 

b7 b6 b5 b4 b3 b2 bt 

1 HCU NOLI GRAPH MARGIN AUX-SENSE 



HCU The HCU (Hard Copy Unit) bit, bit b5, is zero if 

a hard copy un it is attached to the terminal and 
is ready to accept a copy request . Otherwise , 
this bit is one* This bit reflects the status of 
the standard hard copy interface only , even if 
Option 9 (the color hard copy board and 
interface) is installed* 

NOLI, GRAPH In the 4110, the NOLI (No Linear Interpolation) 
and GRAPH (Graph Mode) bits have the following 
meanings : 

NOLI GRAPH 

The terminal is in marker mode * 

1 The terminal is in alpha mode . 

1 The terminal is in vector mode . 

1 1 (This combination does not occur • ) 

MARGIN On a 4114, the MARGIN bit is zero if column 1 is 
in effect (that is , if the terminal has not 
"wrapped around" to column 2 , column 3 > etc . ) The 
MARGIN bit is one if wrap-around has occurred , so 
that column 2, column 3 > etc., is in effect . (See 
<set-margin> for details • ) 

In the 4112, this bit is always zero . 

AUX-SENSE This bit is always one. 

<E0M-Indicator> The <EOM-indicator> ( "end-of-me~sage" indi- 
cator) marks the end of the report • If the terminal is not 
in block mode , this is just the current <EOL-string> , as set 
by the most recent <set-EOL-str ing> command . Typically , this 
is just the "carriage return" character , ( CR) . For more 
details see <EOM-indicator> syntactic construct and <set- 
E0L-string> command • To most closely emulate the 4010 Series 
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terminals, the terminal should not be in block mode. The 
<EOL-string> should be set (by a ( set-EOL-str ing> command) . 

References 

<Report-40 1 0-status> command. 
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<4 953-Tablet-GIN-Report> Syntactic Construct 



SYNTAX 




<liQ5^„tablet~GIN-reDort> - 


r ^ F OM — i n H i nflfnr^ 1 

LnLuII AUUIuCIUUI X J 




^ hp pr-ohar) 




<4QS^ — tabl pt,-xv- rpnort) 




[<EOM~indicator>] . 


<header~char> = < (SUB) or 


(GS) or (US)> 


or <(M) or 


(J) or (0)> . 


<4953-tablet-xy-repor t> = 


<xy-repor t> 


or <1 O-bit-xy-repor t> . 




<1 0-bit-xy-report> = <Hi Y- 


repor t> 


<LoY- 


repor t> 


<HiX- 


repor t> 


y<LoX-repor t> . 





PARTS OF THE REPORT 

<EOM-Indicator> . An <EOM-ind icator> is only sent at the 
start of the report message if both the following conditions 
are met : ( a) At least one character has already been sent on 
this line ( that is , since the last <EOM-ind icator> ) . ( b) If 
the current line were not terminated ( by sending this <EOM- 
indicator> ) , then the rest of this <4 953-tablet-GIN-report> 
would cause the current max imum line length to be exceeded . 

An <EOM-indicator> is only sent at the end of the report 
message if the <set-report-EOM- frequency> command specified 
"more frequent" rather than " less frequent . " 

<Header-Char> . A single ASCII character . The possible header 
characters are determined by the most recent <set-tablet- 
header-charac ter s> command . 

<4953~tablet-xy-report> . The <enable-4953-tablet-GIN> com- 
mand determines whether the cur so r po sition is reported to 
12 bits of of precision ( in the standard <xy-report> for- 
mat) , or to only 10 bits of precision ( in the <1 0-bit-xy- 
report> format) . 



4-618 



4110 SERIES COMMAND REFERENCE 



ALPHABETICAL LISTING 



<1 0-Bit-Xy-Report> . Gives the most-significant 10 bits of 
the cursor's x- and y-coor inates . The format is similar to 
that of the standard <xy-repor t> , except that the <Ex tr a- 
Repor t> byte is omitted. 



Description 

By issuing the < enable-4 953-tablet-GIN> command, you can 
cause the terminal to emulate a TEKTRONIX 4010 Series 
terminal with accessory 4953 or 4954 graphics tablet, (See 
the description of the <enable-4 953-tablet-GIN> command for 
details . ) 

In response to an < enable-4 953-tablet-GIN> command , the 4110 
sends graphic input information to the host computer in a 
format compatible with the format used by TEKTRONIX 4953 or 
4954 graphic tablets ; this format comprises the <4953- 
tablet-GIN-report> . 

When the terminal send s a report to the host , bypass mode is 
entered . ( See < enter- bypa ss- mod e> . ) 

Overall Syntax . The overall syntax of the report is as 
follows : 

<4 953-tablet-GIN-report> = [ <E0M-ind ic ator> ] 

<head er-char> 
<4 953~tablet-xy-report> 

[<EOM~indicator>] 

Each of the four parts of the report is d iscussed separate- 
ly. 
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First [ <EOM-Indicator> ] . The optional <EOM-ind icator> at the 
start of the report occur s in the syntax because of the 
terminal 1 s "maximum report line length" feature. (See the 
description of the < set- repor t- max- line- length> command for 
details,) This <EOM-ind icator> is prefixed to the report if 
it is needed to prevent the terminal T s max imum line length 
from being exceeded > 

If the terminal is not in block mode , the <EOM-ind icator> is 
just the current <EOL-str ing> , as set by the most recent 
< set-EOL-str ing> command . Typically , this is just the 
" carriage return" character , ( C R ) . For more details , see 
<EOM-ind icator> syntactic construct and < set-EOL-str ing> 
command . To most closely emul ate the 4010 Series terminal s , 
the terminal should not be in block mode . The <E0L-str ing> 
should be set ( by a < set-EOL-str ing> command ) . 

<Header-Char> . The header character is analogous to the 
" key" character in ord inary 41 1 0-style <GI N- stroke- re port> s . 
Which characters are used for the <head er-char> depend s on 
the most recent < set- tab let- header- char act ers> command . If 
the < int> parameter in that command was 1 , then the <head er- 
char> is one of the ASCII control characters (GS ) , (SUB) , 
and (US). If the < in t> parameter in that command was (the 
d efaul t) , then the <header-char> is one of the uppercase 
letters ( M) , ( J ) , and (0) . 

For the first po int in a stroke , the <header-char> is (GS ) 
or ( M) . For subsequent points in a stroke , the <header-char> 
is (SUB) or ( J ) . For the last point in a stroke ( when the 
operator ceases to press the pen against the tablet) , the 
<header"-char> is (US ) or (0 ) . 
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<4953-Tablet-Xy-Report>. The <4 953-tablet- xy-report> resem- 
bles the terminal 1 s ord inar y < xy-repor t> , described else- 
where in this section. However, if the <enable- 4953- table t- 
GIN> command specified only 10-bit data, then the <extra- 
repor t> byte is omitted; in that case, the <4953-tablet- xy- 
repor t> contains only four bytes , instead of the five found 
in ord inar y < xy-repor t> s . 

Final [ <EOM-Indicator> ] . The <EOM-ind icator> at the end of 
the report is sent if the most recent < set-repor t-EOM- 
f r equency> command specified that reports are to be sent 
"more frequently" rather than " less frequently Typically , 
this <EOM-ind icator> is just the ( CR ) character . 

References 

<Enable-4953-tablet-GIN> command . 
<En ter-bypass- mode> command . 
<EOM-ind icator> syntactic construct. 
<Se t-repor t-EOM-fr equency> command . 
<Se t- report- si g- char s> command . 
<4 953-tablet- xy-repor t> message type . 
<XY-repor t> syntactic construct. 
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ASCII CHARTS 



This appendix includes a standard ASCII code chart 
and additional ASCII code charts which define the 
specific characters used as parameters (indicated by 
unshaded areas). 



The code charts are: 
Table Description 

A-1 ASCII Code Chart 

A- 2 Characters Used in <Char> Parameters 

A-3 Characters Used in < lnt> and < Int-f > 

Parameters 
A-4 Characters Used in < lnt-Report> 

Parameters 

A-5 Characters Used in <Xy> Parameters 
A-6 Characters Used in < Xy-Report> 
Parameters 



Table A-1 



ASCII (ISO-7-US) CODE CHART 



B5 

BITS 

B4 B3 B2 Bl 






1 




■\ 


1 % 


1 -i 




11 1 


CONTROL 


FIGURES 


UPPERCASE 


LOWERCASE 














NUL 




OLE 

76 


SP 

32 




48 


@ 

64 


P 

80 


\ 

96 


p 

772 











1 


SOH 


DC1 

77 


! 

33 


1 

49 


A 

65 




a 

97 


q 

773 








1 





STX 

2 


DC2 

18 


34 


2 

50 


B 

66 


R 

82 


b 

98 


r 

774 








1 


1 


ETX 

3 


DC3 

79 


# 

35 


3 

57 


C 

67 


S 

83 


c 

99 


s 

775 





1 








EOT 


DC4 

20 


$ 

36 


4 

52 


D 

68 


T 

84 


d 

700 


t 

776 





1 





1 


ENQ 


NAK 

27 


% 

37 


5 

53 


E 

69 


U 

85 


e 

707 


u 

117 





1 


1 





ACK 

6 


SYN 

22 


& 

38 


6 

54 


F 

70 


V 

86 


f 

102 


V 

778 





1 


1 


1 


BEL 7 


ETB 

23 


/ 

39 


7 

55 


G 

77 


w 

87 


g 

703 


w 

779 













BS 

8 


CAN 

24 


( 

40 


8 

56 


H 

72 


X 

88 


h 

704J 


X 

720 










1 


HT 

9 


EM 

25 


) 

47 


9 

57 


I 

73 


Y 

89 


i 

705 


y 

727 







1 





LF 

70 


SUB 

26 


42 


58 


J 

74 


z 

90 


j 

106 


Z 

722 







1 


1 


VT 

11 


ESC 

27 


■f 

43 


59 


K 

75 


[ 

97 


k 

707 


{ 

723 




1 








FF 


FS 

28 


? 

44 


< 

60 


L 

76 


\ 

92 


1 

708 


I* 

724 




1 





1 


CR 

13 


GS 

29 


45 


67 


M 

77 


] 

93 


m 

709 


} 

725 




1 


1 





SO 

74 


RS 

30 


46 


> 

62 


N 

78 


A 

94 


n 

770 


726 




1 


1 


1 


SI 

75 


US 

37 


/ 

47 


? 

63 




79 


~ 95 




111 


RUBOUT 
(DEL) 
727 



* I 

I on some keyboards or systems 
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Table A-2 

CHARACTERS USED IN <CHAR> PARAMETERS 



m 

SITS 

84 m m m 


^0 


0< 
1 




1 

1 1 


1 
W 


,- 0i 


1 t 1 





CONTROL 




UPPERCASE 




I* 











NUL 




DLE : 

w 


SP 

32 




48 


@ 

64 


p 

80 


\ 

96 


p 

772 











1 


SOH 


DC1 


! 

33 


1 

49 


A 

65 


Q 

81 


a 

97 


q 

773 








1 





STX 


DC2 

fa 


34 


2 

50 


B 

66 


R 

82 


b 

98 


r 

774 





fll 


1 


1 


ETX 

3 


DC3 


# 

35 


3 

57 


C 

67 


S 

83 


c 

99 


s 

775 


® l 


1 








EOT 

„4j 


DC4 

. —22. 


$ 

36 


4 

52 


D 

68 


T 

84 


d 

100 


t 

116 





1 





1 


ENQ 

6. 


NAK 


% 

37 


5 

53 


E 

69 


U 

85 


e 

tot 


u 

117 





1 


1 





ACK 

^ 


SYN 




& 

38 


6 

54 


F 

70 


V 

86 


f 

102 


V 

118 





1 


1 


1 


BEL 

7 


ETB 

23 


/ 

39 


7 

55 


G 

77 


W 

87 


g 

703 


w 

119 


1 
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441 


(0(9) 


-441 


(DC)") 


342 


(U)(6) 


-342 


(U)(&) 


392 


(X)(8) 


-392 


wen 


442 


(0<:) 


-442 


(DH 


343 


(U)(7) 


-343 


(u)o 


393 


(X)(9) 


-393 


(X)(")") 


443 


(D(;) 


-443 


(D(+) 


344 


(U)(8) 


-344 


(U)("(") 


394 


(X)(:) 


-394 


(X)(*) 


444 


(D(<) 


-444 


(D(.) 


345 


(U)(9) 


-345 


(U)(")") 


395 


(X)(;) 


-395 


(X)(+) 


445 


(D(-) 


-445 


(D(-) 


346 


(U)(:) 


-346 


(U)W 


396 


(X)(<) 


-396 


(X)(.) 


446 


(D(>) 


-446 


(D(.) 


347 


(U)(;) 


-347 


(U)(+) 


397 


(X)(=) 


-397 


(X)(-) 


447 


(D(?) 


-447 


(D(/) 


348 


(U)(<) 


-348 


(U)(.) 


398 


(X)(>) 


-398 


(X)(.) 


448 


(\)(0) 


-448 


(\)(SP) 


349 


(U)(«) 


-349 


(U)(-) 


399 


(X)(?) 


-399 


(X)(/) 


449 


f^)(D 


-449 


(\)(0 



41 1 COMMAND REFERENCE 
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B-3 



<INT> PARAMETERS 



Table B-1 (Cont) 



REPRESENTING NUMBERS AS <INT> PARAMETERS 



n 


<lnt : n> 


—11 


<lnt : -n> 


n 


<lnt : n> 


— n 


<lnt : -n> 


n 


<int : n> 


— n 


<Srit : — n> 


450 


(\)(2) 


-450 


C\)(") 


500 


LJ(4) 


-500 


(!)($) 


550 


(b)(6) 


-550 


(b)<&) 


451 


(\)(3) 


-451 


(\)(#) 


501 


(_)(5) 


-501 


LJ(%) 


551 


(b)(7) 


-551 


(b)C) 




A \ (a\ 

\\M4J 


— 40& 


l\)(*/ 




V— )(©) 


—502 


(—)(&) 


552 


(b) (8) 


—552 


(b)-("(") 


400 


vAMoJ 


A CO 

— 40o 


A \ /O/ \ 


503 


(_)(7) 


—503 


(_)( ) 


553 


(b)(9) 


—553 


(b)("H 


404 


A 

v\Mo; 


if 

— 404 


\\M»J 


504 


(_)(8) 


—504 


(— )( ( ) 


554 


(b)(:) 


—554 


(b)(*) 


455 


(\)(7) 


-455 


(\)C) 


505 


(_)(9) 


-505 


(-.)(")") 


555 


(b)(;) 


-555 


(b)(+) 


456 


(\)(8) 


-456 


(\)(T) 


506 


(_)(:) 


-506 


(-)(*) 


556 


(b)(<) 


-556 


(b)(.) 


40 f 


A Wq\ 


— 40 f 


(\Jl ) J 


507 


(_)(;) 


—507 


(— )(+ ) 


557 


(b)(= ) 


—557 


(b)(-) 


405 


\\)(.J 


— 40o 


(\M*) 


508 


(__)(<) 


—508 


(—)(,) 


558 


(b)(>) 


—558 


(b)(.) 


>t en 
40w 


\\;U 


—459 


(\M+ ) 


509 


(_)(= ) 


—509 


(-)(-) 


559 


(b)(?) 


—559 


(b)(/) 


460 


(\)(<) 


-460 


(\)(,) 


510 


(-)(>) 


-510 


(-)(.) 


560 


(e)(0) , 


-560 


(O(SP) 


461 




-461 


eo<-) 


511 


(_)(?) 


-511 


(_)(/) 


561 


(c)(1) 


-561 


(c)(!) 


AGO 

4D£ 


\\M>/ 


ion 

— 4t3Z 


(\J(.J 


51 2 


( )(0) 


—51 2 


( )(SP) 


562 


(c)(2) 


—562 


(c)(") 


4DO 


A WO\ 

\\M rj 


A AO 


MM 

(\J(/J 


51 3 


( Ml) 


—513 


( /(!) 


563 


(c)(3) 


—563 


(c)(#) 


AAA 
404 


flWrrt 

umu; 


— 4o4 


(JJloP) 


51 4 


( )(2) 


—51 4 


( )( ) 


564 


(c)(4) 


—564 


(c)($) 


465 


Q)(1) 


-465 


a)(!) 


515 


0(3) 


-515 


0(#) 


565 


(c)(5) 


-565 


(c)(%) 


466 


a) (2) 


-466 


(])(") 


516 


0(4) 


-516 


0($) 


566 


(c)(6) 


-566 


(c)(&) 


A ft? 

40 f 


\JMo; 


—467 


U)(#) 


51 7 


V )(5) 


—51 7 


( )(%) 


567 


(c)(7) 


—567 


(c)C) 


4QO 


\JM4J 


—468 


(JJ(3>) 


51 8 


( M6) 


—51 8 


()(&) 


588 


(c)(8) 


—568 


(e) ("(") 


4oy 


n\/c\ 
UMo; 


—469 


(J)(%) 


519 


V )(7) 


—519 


OC) 


569 


(c)(9) 


—569 


(c)(")") 


470 


0)(6) 


-470 


(M&) 


520 


0(8) 


-520 


OCT) 


570 


(c)(:) 


-570 


(c)(*) 


471 


0) (7) 


-471 


a)o 


521 


0(9) 


-521 


om 


571 


(c)(;) 


-571 


(c)(+) 


472 


n\/Q\ 

Um8) 


—472 


(J)( ( ) 


522 


()(:) 


—522 


o(*) 


572 


(c)(<) 


-572 


(c)(,) 


473 


UM9) 


—473 


(])()) 


523 


()(;) 


—523 


0(4- ) 


573 


(c)(=) 


-573 


(c)(-) 


At A 


UM.J 


—474 


(J)(*) 


524 


it\i ^\ 
OK) 


—524 


(')(,) 


574 


(c)(>) 


—574 


(c)(.) 


475 


0)(;) 


-475 


an+) 


525 


0(=) 


-525 


O(-) 


575 


(c)(?) 


-575 


(c)(/) 


476 


(])«) 


-476 


(])(,) 


526 


(')(>) 


-526 


(')(.)■ 


576 


(d)(0) 


-576 


(d)(SP) 


477 




—477 


(])(-) 


527 


0(?) 


—527 


(')(/) 


577 


(d)(1) 


-577 


(d)(!) 


478 


(JM>) 


—478 


(])(•) 


528 


(a)(0) 


—528 


(a)(SP) 


578 


(d)(2) 


—578 


(d)(") 


479 


IJ)(?) 


—479 


/IV /A 


529 


(a)(1) 


—529 


(a)(!) 


579 


(d)(3) 


-579 


(d)(#) 


480 


(A)(0) 


-480 


(A)(SP) 


530 


(a)(2) 


-530 


(a)(") 


580 


(d)(4) 


-580 


(d)($) 


481 


(A)(1) 


-481 


(A)(!) 


531 


(a)(3) 


-531 


(a)(#) 


581 


(d)(5) 


-581 


(d)(%) 


40£ 


\A)\2) 


—482 


/ A W»»\ 

(A)( ) 


532 


(a)(4) 


—532 


(a)($) 


582 


(d)(6) 


—582 


(d)(&) 


483 


(A)(3) 


—483 


( A)(#) 


533 


(a)(5) 


—533 


(a)(%) 


583 


(d)(7) 


-583 


(d)C) 


4o4 


(A)(4) 


—484 


( A) 1$) 


534 


(a)(6) 


—534 


(a)(&) 


584 


(d)(8) 


—584 


(d)("(") 


485 


(A)(5) 


-485 


(A)(%) 


535 


(a)(7) 


-535 


(a)C) 


585 


(d)(9) 


-585 


(d)CT') 


486 


(A)(6) 


-486 


(AM&) 


536 


(a)(8) 


-536 


(a)("(") 


586 


(d)(:) 


-586 


(d)(*) 


487 


(A)(7) 


—487 


(A)( ) 


537 


(a)(9) 


—537 


(a)(")") 


587 


(d)(;) 


—587 


(d)(+) 


488 


(A)(8) 


-488 


(A)(T) 


538 


(a)(:) 


-538 


(a)(*) 


58S 


(d)(<) 


-588 


(d)(.) 


489 


(A)(9) 


-489 


(A)(T) 


539 


(a)(;) 


-539 


(a)(+) 


589 


(d)(=) 


-589 


(d)(-) 


490 


(A)(:) 


-490 


(A)(*) 


540 


(a)(<) 


-540 


(a)( f ) 


590 


(d)(>) 


-590 


(d)(.) 


491 


(AM;) 


-491 


<A)<+) 


541 


(a)(=) 


-541 


(a)(-) 


591 


(d)(?) 


-591 


(d)(/) 


492 


(A)(<) 


-492 


(A)(.) 


542 


(a)(>) 


-542 


(a)(.) 


592 


(e)(0) 


-592 


(e)(SP) 


493 


(A)(-) 


-493 


(A)(-) 


543 


(a)(?) 


-543 


(a)(/) 


593 


(e)(1) 


-593 


(©)(!) 


494 


(A)(>) 


-494 


(A)(.) 


544 


(b)(0) 


-544 


(b)(SP) 


594 


(e)(2) 


-594 


(e)(") 


495 


(A)(?) 


-496 


(A)(/) 


545 


(b)(1) 


-545 


(b)(!) 


595 


(e)(3) 


-595 


(@)(#) 


496 


(_)(0) 


-496 


(_)(SP) 


546 


(b)(2) 


-546 


(b)H 


596 


(e)(4) 


-596 


(©)($) 


497 


(_)(1) 


-497 


(_)(!) 


547 


(b)(3) 


-547 


(b)(#) 


597 


(e)(5) 


-597 


(@)(%) 


498 


(_)(2) 


-498 


<-)<") 


548 


(b)(4) 


-548 


(b)($) 


598 


(e)(6) 


-598 


(e)(&) 


499 


(_)(3) 


-499 


(_)(#) 


549 

L_ 


(b)(5) 


-549 


(b)(%) 


599 


(e)(7) 


-599 


(e)C) 



B»4 



REV, DEC 1981 



41 1 COMMAND REFERENCE 



<INT> PARAMETERS 



Table B-1 (Cont) 

REPRESENTING NUMBERS AS <INT> PARAMETERS 



n 


<lnt : n> 




<lnt : — n> 


n 


<lnt : n> 


— n 


~* 

<lnt : -n> 


n 


<lnt : n> 


— n 


<lnt : -n> 


600 


(e)(8) 


-600 


(e) (•*(") 


650 


(h)(:) 


-650 


(h)(*) 


700 


(k)(<) 


-700 


(k)(,) 


OU1 




— DU I 


} ) 


DO 1 


fhYM 


— DOT 


/U\/i \ 

\n)\-r ) 


701 


IKM— J 


—701 


(k; (») 


602 


(e)(.) 


-602 


(e)(») 


652 


(h)(<) 


-652 


(h)( f ) 


702 


(k)(>) 


— 702 


(k)(.) 


603 


(e)(;) 


-603 


(e)(+) 


653 


(h)(=) 


-653 


(h)(-) 


703 


(k)(?) 


—703 


(k)(/) 


604 


(e)(<) 


-604 


(e)(.) 


654 


(h)(>) 


-654 


(h)(.) 


704 


(0(0) 


-704 


(|)(SP) 


605 


(e)(=) 


-605 


(e)(-) 


655 


(h)(?) 


-655 


(h)(/) 


705 


(0(1) 


-705 


(0(0 


fine 

DUO 


{©){>) 


— DUD 


\®)\.) 


bob 


iiMUj 


— OOO 




706 


(0(2) 


—706 




607 


(e)(7) 


-607 


(e)(/) 


657 


(0(1) 


-657 


(0(!) 


707 


(I) (3) 


—707 


(0(#) 


608 


(f)(0) 


-608 


(f)(SP) 


658 


"(0(2) 


-658 


OK") 


708 


(I) (4) 


—708 


(0($) 


609 


(f)(1) 


-609 


(f)(!) 


659 


(i)(3) 


-659 


(0(#) 


709 


(I) (5) 


—709 


(0(%) 


610 


(f)(2) 


-610 


(f)(") 


660 


(i)(4) 


-660 


(0($) 


710 


(0(6) 


-710 


(l)(&) 


61 1 


UMOj 


— Dl 1 


un#; 


661 


UMoJ 


—661 




71 1 


li\l-r\ 

(0(7) 


—71 1 


(0( ) 


612 


(f)(4) 


-612 


(f)($) 


662 


(j)(6) 


—662 


(i)(&) 


712 


(0(8) 


—712 


(!)("(") 


613 


(f)(5) 


-613 


(f)(%) 


663 


(0(7) 


-663 


(OC) 


713 


(|)(9) 


—713 


(DC)") 


614 


(f)(6) 


-614 


(f)(&) 


664 


(i)(8) 


—664 


(om 


714 


(|)( : ) 


—714 


(D(«) 


615 


(f)(7) 


-615 


(f)C) 


665 


(0(9) 


-665 


(OCT) 


715 


OH;) 


-715 


(0(+) 


61 6 


lt\la\ 
\V\of 


—61 6 


\V\ \ ) 


666 




—666 


(D(*) 


716 


ti\( ^\ 
(0«) 


—716 


(0(J 


617 


(f)(9) 


-617 


(f) (««)'•) 


667 


OK;) 


-667 


(!)(+) 


717 


(|)(=) 


—717 


(D(-) 


618 


(f)(:) 


-618 


(f)(*) 


668 


(0(<) 


-668 


OH,) 


718 


(0(>) 


-718 


(0(.) 


619 


(f)(;) 


-619 


(f)(+) 


669 


(0(=) 


-669 


0H-) 


719 


(l)(?) 


-719 


(!)(/) 


620 


(f)(<) 


-620 


(f)(,) 


670 


(0(» 


-670 


(0(.) 


720 


(m)(0) 


-720 


(m)(SP) 


Kid I 


\tf\— t 


— Dd I 


u/\-/ 


R71 
Of I 


\\f\f) 


ft71 
—Of 1 


\ifvf 


701 

f d\ 




701 


f m Wh 


622 


(f)(>) 


-622 


(f)(.) 


672 


(j)(0) 


-672 


(j)(SP) 


722 


(m)(2) 


-722 


(m)C) 


623 


(f)(?) 


-623 


(f)(/) 


673 


(j)(D 


-673 


(j)(D 


723 


(m)(3) 


-723 


(m)(#) 


624 


(g)(0) 


-624 


(g)(SP) 


674 


0)(2) 


-674 


OH") 


724 


(m)(4) 


-724 


(m)($) 


625 


(g)(D 


-625 


(g)(!) 


675 


(i)(3) 


-675 


0)(#) 


725 


(m)(5) 


-725 


(m)(%) 


Od\} 




— D<£0 


vy/V / 


Or D 


VI/ w 


—Of D 




79ft 


/ m Wft\ 

\mMD/ 


70ft 

— * dV 


\n\)\tkf 


627 


(g)(3) 


-627 


(g)(#) 


677 


(i)(5) 


-677 


0)(%) 


727 


(m)(7) 


-727 


(m)C) 


628 


(g)(4) 


-628 


(g)($) 


678 


(j)(6) 


-678 


0)(&) 


728 


(m)(8) 


-728 


(m)("(") 


629 


(g)(5) 


-629 


(g)(%) 


679 


(i)(7) 


-679 


0)C) 


729 


(m)(9) 


-729 


(m)(")") 


630 


(g)(6) 


-630 


(g)(&) 


680 


0)(8) 


-680 


0)("(") 


730 


(m)(:) 


-730 


(m)(*) 


DO I 


\Q)\f) 


— Do I 


IQM J 


DO I 




' — DO 1 


VJM / / 


f ol 


( m \(.\ 


7'a-i 




632 


(g)(8) 


-632 


(g) («'(»') 


682 


OH:) 


-682 


OH*) 


732 


(m)(<) 


-732 


(m)(,) 


633 


(g)(9) 


-633 


(g)( ,! )") 


683 


(])(;) 


-683 


0H+) 


733 


(m)(=) 


-733 


(m)(-) 


634 


(g)(:) 


-634 


(g)(*) 


684 


(j)(<) 


-684 


OK,) 


734 


(m)(>) 


-734 


(m)(.) 


635 


(g)(;) 


-635 


(g)(+) 


685 


(j)(=) 


-685 


0M-) 


735 


(m)(?) 


-735 


(m)(/) 


636 


(g)(<) 


-636 


(g)U 


686 


0H>) 


-688 


OK) 


736 


(n)(0) 


-736 


(n)(SP) 


637 


(g)(=) 


-637 


(g)(-) 


687 


(i)(?) 


-687 


OK/) 


737 


(n)(1) 


-737 


(n)(0 


638 


(g)(>) 


-638 


(g)(.) 


688 


(k)(0) 


-688 


(k)(SP) 


738 


(n)(2) 


-738 


(n)(") 


639 


(g)(?) 


-639 


(g)(7) 


689 


(k)(1) 


-689 


(k)(!) 


739 


(n)(3) 


-739 


(n)(#) 


640 


(h)(0) 


-640 


(h)(SP) 


690 


00(2) 


-690 


(k)C) 


740 


(n)(4) 


-740 


(n)($) 


641 


(h)(1) 


-641 


(h)(!) 


691 


(k)(3) 


-691 


(k)(#) 


741 


(n)(5) 


-741 


(n)(%) 


642 


(h)(2) 


-642 


(h)(") 


692 


00(4) 


-692 


(k)($) 


742 


(n)(6) 


-742 


(n)(&) 


643 


(h)(3) 


-643 


(h)(#) 


693 


00(5) 


-693 


O0(%) 


743 


(n)(7) 


-743 


(n)C) 


644 


(h)(4) 


-644 


(h)($) 


694 


(k)(6) 


-694 


(k)(&) 


744 


(n)(8) 


-744 


(n)("(") 


645 


(h)(5) 


-645 


(h)(%) 


695 


(k)(7) 


-695 


(k)C) 


745 


(n)(9) 


-745 


(n)C0") 


646 


(h)(6) 


-646 


(h)(&) 


696 


(k)(8) 


-696 


(k)("(") 


746 


(n)(:) 


-746 


(n)(*) 


647 


(h)(7) 


-647 


(h)C) 


697 


00(9) 


-697 


000')") 


747 


(n)(;) 


-747 


(n)<+) 


648 


(h)(8) 


-648 


(h)(T) 


698 


00(.) 


-698 


00(*) 


748 


(n)(<) 


-748 


(n)(.) 


649 


(h)(9) 


-649 


(h)OT') 


699 


O0(;) 


-699 


00(+) 


749 


(n)(=) 


-749 


(n)(-) 



41 1 COMMAND REFERENCE 
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B-5 



<INT> PARAMETERS 



Table B-1 (Coot) 



REPRESENTING NUMBERS AS <SNT> PARAMETERS 



n 


< Int : n> 




< Snf : — n> 


n 


< Int : n> 


—si 


<int ; -n> 


n 


< Int : n> 


_n 


< Int : — n> 


750 


(n)(>) 


—750 


(n)(.) 


800 


(r)(0) 


—800 


(r)(SP) 


850 


(u)(2) 


-850 


— — 
(u)(") 


751 


(n)(?) 


— 751 


(n)(/) 


801 


(r)(D 


—801 


( r )(l) 


851 


(ij) (3) 


—851 


{ U )l#) 
\Uf\fFf 


752 


(o)(0) 


-752 


(o)(SP) 


802 


(r)(2) 


-802 


OK") 


852 


(u)(4) 


-852 


(u)($) 


753 


(o)(1) 


-753 


(o)(!) 


803 


(r)(3) 


-803 


(r)(#) 


853 


(u)(5) 


-853 


(u)(%) 


754 


(o)(2) 


-754 


(o)(") 


804 


(r)(4) 


-804 


(r)($) 


854 


(u)(6) 


-854 


(u)(&) 


755 


(0) (3) 


— 755 


(o)(#; 


805 


(r)(5) 


—805 


(r)(%) 


855 


(u)(7) 


—855 


(u)C) 


756 


(o)(4) 


— 756 


(o)($) 


806 


(r)(6) 


—806 


(r)(&) 


356 


(u)(8) 


—856 


\ / 


757 


(o)(5) 


-757 


(o)(%) 


807 


(r)(7) 


-807 


(r)C) 


857 


(u)(9) 


-857 


(u) (")") 


758 


(Q)(6) 


-758 


(o)(&) 


808 


(r)(8) 


-808 


(r)(T) 


858 


(u)(:) 


-858 


(u)W 


759 


(o)(7) 


-759 


(o)C) 


809 


(r)(9) 


-809 


(r)(") M ) 


859 


(u)(;) 


-859 


(u)(+) 


760 


(0)18) 


— 760 


/„ V /<t/H\ 

(o)( I ) 


81 


(r)(:) 


—810 


(r)(*) 


860 


(u)(<) 


—860 


(u)(,) 


761 


(o)(9) 


— 761 


(o)O 1 )") 


81 1 


(r)( ; ) 


—81 1 


(r)(+) 


861 


( u )(=) 


—861 


(u){~) 


762 


(o)(:) 


-762 


(o)(*) 


812 


(r)(<) 


-812 


(r)(.) 


862 


(u)(>) 


-862 


(u)(.) 


763 


(o)(;) 


-763 


(o)O) 


813 


(r)(=) 


-813 


(r)(-) 


863 


(u)(?) 


-863 


(u)(/) 


764 


(o)(<) 


-764 


(o)(,) 


814 


(r)(>) 


-814 


(r)(.) 


864 


(v)(0) 


-864 


(v)(SP) 


765 


(0)A~ ) 


— 765 


(o)l» 


81 5 


(r)(?) 


—81 5 


(r)(/) 


865 


(v)(1) 


—865 


(v)(!) 


766 


(o)(>) 


— 766 


(o)(.) 


816 


(a)(0) 


—816 


(s)(SP) 


866 


(v)(2) 


—866 


(v)(") 


767 


(o)(?) 


-767 


(o)(/) 


817 


(s)(1) 


-817 


(s)(!) 


867 


(v)(3) 


-867 


(v)(#) 


768 


(p)(0) 


-768 


(p)(SP) 


818 


(s)(2) 


-818 


(s)(") 


868 


(v)(4) 


-868 


(v)($) 


769 


(p)(1) 


-769 


(p)(!) 


819 


(s)(3) 


-819 


(s)(#) 


869 


(v)(5) 


-869 


(v)(%) 


770 


(pM2) 


— 770 


(P)( ) 


820 


(a)(4) 


—820 


(s)($) 


870 


(v)(6) 


—870 


(v)(&) 


771 


(p)(3) 


— 771 


(P)(^ 


821 


(s)(5) 


—821 


(s)(%) 


871 




—871 




772 


(p)(4) 


-772. 


(P)(S) 


822 


(s)(6) 


-822 


(8)(&) 


872 


(v)(8) 


-872 


(v) ("(") 


773 


(p)(5) 


-773 


(P)(%) 


823 


(b)(7) 


-823 


(s)C) 


873 


(v)(9) 


-873 


(v)(T) I 


774 


(p)(6) 


-774 


(P)(&) 


824 


(8) (8) 


-824 


(s)(T) 


874 


(v)(:) 


-874 


(v)(*) 


775 


(p)(7) 


— 775 


(p)C) 


825 


(s)(9) 


—825 


(8).(")") 


875 


(v)(;) 


-875 


(v)(+.) 


776 


(p)(8) 


— 776 


(p)C'C') 


826 


($)(:) 


—826 


( S )(*) 


876 


(ss)(<) 


—876 


(y)l ) 


777 


(p).(9) 


-777 


(p)<")"> 


827 


(*)(;) 


-827 


(s)(+) 


877 


(v)(«) 


-877 


(v)(-) 


778 


(p)(:) 


-778 


<p)H 


828 


(s)(<) 


-828 


(s)(.) 


878 


(v)(>) 


-878 


(v)(.) 


779 


(p)(;) 


-779 


(p)(+) 


829 


(8)(-) 


-829 


(8)(-) 


879 


(v)(?) 


-879 


(v)(/) 


780 


(p)(<) 


— 780 


(p)(.) 


830 


(s)(>) 


—830 


(s)(.) 


880 


(w)(0) 


—880 


(w)(SP) 


781 


(p)(=) 


— 781 


(n)(.) 


831 


(s)(?) 


—831 




881 




—881 




782 


(p)(>) 


-782 


(P)(.) 


832 


(t)(0) 


-832 


(t)(SP) 


882 


(w)(2) 


-882 


(w)C) 


783 


(p)(?) 


-783 


(P)(/) 


833 


(t)(1) 


-833 


(t)(!) 


883 


(w)(3) 


-883 


(w)(#) 


784 


(q)(0) 


-784 


(q)(SP) 


834 


(t)(2) 


-834 


(t)(") 


884 


(w)(4) 


-884 


(w)($) 


785 


(q)(1) 


— 785 


(q)(!) 


835 


(t)(3) 


-835 


(t)(#) 


885 


(w)(5) 


-885 


(w)(%) 


786 


(q)(2) 


-786 


(q)(") 


836 


(t)(4) 


-836 


(t)($) 


886 


(w)(6) 


-886 


(w)(&) 


787 


(q)(3) 


-787 


(q)(#) 


837 


(t)(5) 


-837 


(t)(%) 


887 


(w)(7) 


-887 


(w)C) 


788 


(q)(4) 


-788 


(q)($) 


838 


(t)(6) 


-838 


(t)(&) 


888 


(w)(8) 


-888 


(w)OT) 


789 


(q)(5) 


-789 


(q)(%) 


839 


(t)(7) 


-839 


(t)C) 


889 


(w)(9) 


-889 


M(T) 


790 


<q)(6) 


-790 


(q)(&) 


840 


(t)(8) 


-840 


(t)(T) 


890 


(w)(:) 


-890 


(w)H 


791 


(q)(7) 


-791 


(q)C) 


841 


(t)(9) 


-841 


(t)(T) 


891 


(w)(;) 


-891 


(w)(+) 


792 


(q)(8) 


-792 


(qH'T) 


842 


(t)(:) 


-842 


(t)(*) 


892 


(w)(<) 


-892 


(w)(.) 


793 


(q)(9) 


-793 


(q)(T) 


843 


(t)(;) 


-843 


(t)(+) 


893 


(w)(-j 


-893 


(w)(-) 


794 


(q)(:) 


-794 


(q)(*) 


844 


(t)(<) 


-844 


(t)(.) 


894 


(w)(>) 


-894 


(w)(.) 


795 


(q)(;) 


-795 


<q)<+) 


845 


<t)(«) 


-845 


(t)(-) 


895 


(w)(?) 


-895 


(w)(/) 


796 


(q)(<) 


-796 


(q)(.) 


846 


(t)(>) 


-846 


(t)(.) 


896 


(x)(0) 


-896 


(x)(SP) 


797 


<q)(-) 


-797 


(q)<-) 


847 


(t)(?) 


-847 


(t)(/) 


897 


(x)(1) 


-897 


(x)(!) 


798 


(q)(>) 


-798 


(q)(.) 


848 


(u)(0) 


-848 


(u)(SP) 


898 


(x>(2) 


-898 


(x)(") 


799 


(q)(?) 


-799 


(q)(/) 


849 

U— 


(U)(1) 


-849 


(u)(!) 


899 


(x)(3) 


-899 


(x)(#) 
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Table B-1 (Cent) 



REPRESENTING NUMBERS AS <INT> PARAMETERS 



n 


< Silt : n> 


— "R 


< Siif : -»n> 


n 


< int : n> 


n 


< int : -n> 




<? Int " n*> 






<c Int i — n> 


900 


(x) (4) 


—900 


( x )($) 


950 


(0(6) 


—950 


(0(&) 


1000 


(—)(8) 




1 000 




901 


(x)(5) 


-901 


(x)(%) 


951 


(0(7) 


-951 


(DC) 


1001 


(-)(9) 




1001 


(-)(")") 


902 


(x)(6) 


-902 


(x)(&) 


952 


(0(8) 


-952 


(Dm 


1002 


(-)(:) 


- 


1002 


(-)(*) 


903 


(x)(7) 


-903 


(x)C) 


953 


(0(9) 


-953 


(OH") 


1003 


(-)(;) 


— 


1003 


(~)(+) 


904 


(x)(8) 


-904 


(x) ('«(") 


954 


({)(:) 


-954 


(()(*) 


1004 


(-)(<) 


— 


004 


(-)(,) 


905 




—905 




955 


\ i / \ » / 


—955 




1 005 


\ f\ ) 




1 005 


\ / \ / 


906 


(x)(:) 


-906 


«(*) 


956 


({)(<) 


-956 


(()(,) 


1006 


(-)(>) 


I 


1006 


(-)(.) 


907 


(x)(;) 


-907 


(x)(+) 


957 


(()(=) 


-957 


(D(-) 


1007 


<~)(?) 


- 


1007 


(-)(/) 


908 


(x)(<) 


-908 


(x)(.) 


958 


(()(>) 


-958 


(DO 


1008 


(DEL)(0) 


— 


1008 


(DEL)(SP) 


909 


(x)(=) 


-909 


(x){~) 


959 


({)(?) 


-959 


(()(/) 


1009 


(DEL)(1) 


— 


1009 


(DEL)O) 


91 


( x )(>) 


—910 


(x)(.) 


960 


\|/ \v// 


—960 




1 01 


(DEL 




inin 


(DPI )(") 


911 


(x)(?) 


-911 


(x)(/) 


961 


(|)(D 


-961 


(|)(!) 


1011 


(DEL) (3) 




1011 


(DEL)(#) 


912 


(y)(0) 


-912 


(y)(SP) 


962 


(|)(2) 


-962 


(DO 


1012 


(DEL) (4) 


- 


1012 


(DEL)($) 


913 


(y)(D 


-913 


(y)(D 


963 


(D<3) 


-963 


(|)(#) 


1013 


(DEL) (5) 


— 


1013 


(DEL)(%) 


914 


(y)(2) 


-914 


(y)(") 


964 


(|) (4) 


-964 


(|)($) 


1014 


(DEL) (6) 


— 


1014 


(DEL)(&) 


91 5 


\yl \o; 


— 57 1 □ 


\yl\fr! 


OAK 

WW 


(|Wc) 

\\l\Ol 




\\}\f0f 


1 ni 

I u i a 






I U I o 


\UHLM t 


916 


(y)(4) 


-916 


(y)($) 


966 


(|)(6) 


-966 


(l)(&) 


1016 


(DEL) (8) 




1016 


(DEL)CI") 


917 


(y)(5) 


-917 


(y)(%) 


967 


(|) (7) 


-967 


(DC) 


1017 


(DEL) (9) 


— 


1017 


(DEum 


918 


(y)(6) 


-918 


(y)(&) 


968 


(|) (8) 


-968 


(Dm 


1018 


(DELM:) 


— 


1018 


(DEL)(*) 


919 


(y)(7) 


-919 


(y)C) 


969 


(|)(9) 


-969 


(DC)") 


1019 


(DEL)(;) 


— 


1019 


(DEL)(+) 


920 


vy/\o; 


—920 


\y/v \ / 


970 


\\f\j 


—970 




1 non 

I \J£,\J 






i c\on 

! \Jc.\J 




921 


(y)(9) 


-921 


(y)('«)") 


971 


(|)(;) 


-971 


(l)(+) 


1021 


(DEU(-) 




1021 


(DED(-) 


922 


(y)(:) 


-922 


(y)(*) 


972 


(|)(<) 


-972 


(DO 


1022 


(DEL)(>) 




1 022 


(DEL)(.) 


923 


(y)(;) 


-923 


(y)(+) 


973 


(|)(=) 


-973 


(|)(-) 


1023 


(DEL)(?) 


— 


1023 


(DEL)(/) 


924 


(y)(<) 


-924 


(y)U 


974 


(|)(>) 


-974 


(D(.) 


1024 


(A)(@)(0) 


- 


1024 


(A)(@)(SP) 


925 


\yi\— 1 


—925 


\y/i / 


975 


(\)(o) 

\\/\ If 


—975 


1\)IA 

\\l vf 


1 DOR 


\n}\i{yf \ i ; 




1 %J£.0 




926 


(y)(>) 


-926 


(y)(.) 


976 


(})(0) 


-976 


())(SP) 


1026 


(A)(@)(2) 




1026 


(A)(@)(") 


927 


(y)(?) 


-927 


(y)(/) 


977 


())(D 


-977 


(})(!) 


1027 


(A)(@)(3) 




1027 


(A)(@)(#) 


928 


(z)(0) 


-928 


(z)(SP) 


978 


(})(2) 


-978 


())(") 


1028 


(A)(@)(4) 


— 


1028 


(A)(@)($) 


929 


(z)(D 


-929 


(z)(!) 


979 


())(3) 


-979 


())(#) 


1029 


(A)(@)(5) 


— 


1029 


(A)(@)(%) 


930 


\£.f \£,f 


""SOU 




SJOU 




— «70U 


\) I V¥l 


I U«3U 






1 U<3U 




931 


fe)(3) 


-931 


(z)(#) 


981 


(})(5) 


-981 


())(%) 


1031 


(A)(@)(7) 




1031 


(A)(@)C) 


932 


(z)(4) 


-932 


(z)($) 


982 


())(6) 


-982 


(!)(&) 


1032 


(A)(@)(8) 


— 


1032 


(A)(@MT) 


933 


(z)(5) 


-933 


(z)(%) 


983 


())(7) 


-983 


(DC) 


1033 


(A)(@)(9) 


— 


1033 


(A)(@)( M )") 


934 


(z)(6) 


-934 


(z)(&) 


984 


(})(8) 


-984 


(})("(") 


1034 


(A)(@)(:) 


— 


1034 


(A)(@)(*) 


935 


h)(7) 






QjOC 


I) )IQ) 




MIX f f 








1 U%50 


\S\) \ \~T ) 


936 


(z)(8) 


-936 


(z) ("(") 


986 


())(:) 


-986 


(})(*) 


1036 


(A)(@)(<) 




036 


(A)(@)(J 


937 


V&/V9/ 


—937 


\£.) \ ) I 


QQ7 


(i )() 

M Mi/ 


„QC37 
— tJ© I 




1 n*\7 

I U*3/ 


(A)((a>)(— ) 

\ni\'&i\— t 




! UOl 


(A) (&)(-) 


938 


(z)(:) 


-938 


(z)(*) 


988 


())(<) 


-988 


(})(,) 


1038 


(A)(@)(>) 




038 


(A)(@)(.) 


939 


(z)(;) 


-939 


(z)(+) 


989 


(})(=) 


-989 


())(-) 


1039 


(A)(@)(?) 




1039 


(A)(@)(/) 


940 


(z)(<) 


-940 


(z)(.) 


990 


(})(>) 


-990 


())(.) 


1040 


(A)(A)(0) 




040 


(A)(A)(SP) 


941 


(z)(=) 


-941 


(z)(-) 


991 


(})(?) 


-991 


())(/) 


1041 


(A) (A)(1) 




041 


(A) (A)(1) 


942 


(z)(>) 


-942 


(z)(.) 


992 


(~)(0) 


-992 


(~)(SP) 


1042 


(A)(A)(2) 




042 


(A)(A)(") 


943 


(z)(?) 


-943 


(z)(/) 


993 


(~)(1) 


-993 


(~)(l) 


1043 


(A)(A)(3) 




043 


(A)(A)(#) 


944 


(0(0) 


-944 


(OOP) 


994 


(~)(2) 


-994 


(-)(") 


1044 


(A)(A)(4) 




044 


(A)(A)($) 


945 


(0(1) 


-945 


({)(!) 


995 


(~)(3) 


-995 


(-)(#) 


1045 


(A) (A)(5) 




045 


(A)(A)(%) 


946 


(0(2) 


-946 


(on 


996 


(~)(4) 


-996 


(-)($) 


1046 


(A) (A)(6) 




046 


(A)(A)(&) 


947 


(0(3) 


-947 


({)(#) 


997 


<-~)<5) 


-997 


(-)(%) 


1047 


(A)(A)(7) 




047 


(A)(A)C) 


948 


(0(4) 


-948 


({)($) 


998 


(~)(8) 


-998 


(-)(&) 


1048 


(A)(A)(8) 




048 


(A)(A)(««n 


949 


(0(5) 


-949 


({)(%) 


999 


(~)(7) 


-999 


(~)C) 


1049 


(A) (A) (9) 




049 


(A)(A)C)") 
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Appendix C 
ERROR CODES 



INTRODUCTION 

Each error condition which a 4110 series terminal can detect 
has an error code and a severity level . 

When the terminal detects an error condition, it stores the 
error code in a limited-size queue for later retrieval by a 
< report-error s> commmand . 

If the error 1 s severity level is greater than or equal to 
the current error threshold, then the terminal displays a 
message for the operator . When the terminal is shipped from 
the factory, its error threshold is set to 2; thus the only 
errors displayed are those with a severity level of 2 or 
more . The error threshold is remembered even when the 
terminal is turned off; it can be changed with the <set- 
error-threshold> command . 



Severity Levels 

There are four severity levels, numbered from zero to threes 

Level 0. Errors of severity level zero are hardly 
errors at all. The associated message begins with the 
words "Terminal issues message... ". Typically, these 
errors occur for commands which are not installed. For 
instance , when 4112 commands are sent to a 4114, the 
terminal detects level zero errors. 

Level 1 . Level one errors are "warnings." The corre- 
sponding messages begin with the words " Terminal is- 
sues warning " . Typically these occur when the 

command is inappropriate: deleting a segment that does 
not exist , for example. 

Level 2. Level two errors result from invalid com- 
mands. For instance, a command 1 s parameter may be 
outside the specified range. The corresponding message 
begins with the words, "Terminal detects error ...". 
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Level 3« Level three errors occur when the command is 
valid, but for some reason the terminal cannot execute 
the command . (For instance, there may be insufficient 
memory to hold all the information being included in a 
segment definition,) For these errors, the message 
starts with the word, "Terminal system error , . ." . 



Error Codes 

The error codes are each composed according to the following 
scheme : 

Each error code consists of four characters. 

In most error codes, the first two characters are the 
op code for some command-- the command being executed 
when the error is detected. For example, error IA11 is 
associated with the <set-~pick~»aperture> command. 

Some errors, however, are associated with no particu- 
lar command. For these errors, the first two 
characters are a letter and a digit. For instance, 
error 1011 (invalid device-function code) can occur 
with many graphic input commands. Again, error J 1 09 
(disk hardware initialization error) can occur only 
when the terminal is turned on before any commands 
have been sent to it. 

The third character in an error code is a numeric 
digit. Digits from 1 to 9 name the -.parameter with 
which the error is associated. Digit indicates that 
the error is associated with the command as a whole: 
the op code itself is regarded as the "zeroeth 
parameter," 
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The fourth character in an error code is also a digit. 
The most frequently used digits here are 0, 1 , 2, 
and 3 1 

: Indicates an "existence problem, 11 The object 

referred to does not exist when it ought to exist, 
or does exist when it ought not to exist. 

1 : Indicates an "invalid value." 

2 : Indicates an "out of memory problem." 

3 : A "context error." The command is valid, but 

cannot be executed at this time. (For instance, 
trying to end a segment when no segment is cur- 
rently being defined.) 

For example, consider the "S0 10" error code. Here, "SO" 
means the <begin-segment> command, which has the syntax 
(ESC) (S)(0)<int>. The "1" refers to the first (and only) 
parameter of that command , which is the segment number . The 
"0" indicates an "existence problem; " the segment referred 
to already exists . 

Commands Not Installed in the Terminal 

Op codes beginning with letters A to H are reserved for 
other Tektronix products. The terminal detects an error if 
it receives an escape sequence command with such an op code . 

The remaining op codes (those beginning with letters from I 
to Z) may occur in present or future 4110 Series terminals. 
When the terminal receives one of these escape-sequence 
commands and does not recognize that command , it detects an 
error (of severity level zero) . After detecting the error , 
the terminal then ignores all subsequent characters until it 
receives an (ESC) , (GS) , (FS) , or (US) character. (It does 
this so as to skip over any parameters for the unrecognized 
command . ) 

For instance , suppose the terminal does not have Option 01 
installed , and the host sends it the following character 
sequence : 

(ESC)(0)(D)(0)(ESC)(K)(A)(1) 
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Since Option 01 is not installed, the terminal does not 
recognize the <set-duplex-mode : 0> command, (ESC) (0) (D) (0) . 
On receiving the (ESC) (0)(D) op code, it detects a type OD00 
error (and displays the OD00 error message if the error 
threshold is set to zero) . It ignores the following charac- 
ter, (0). On receiving the following (ESC), it resumes 
processing of the characters received, so that it correctly 
interprets and executes the <enable-dialog-area : 1> command, 
(ESC)(K)(A)(1). 

If your host program sends commands that may not be in- 
stalled in all 4110 Series terminals , then these commands 
should be followed by other commands which are recognized by 
all terminals in the series. For instance , after issuing 
commands to change 4112-only settings , the host could send a 
(US) character (the <enter-alpha-mode> command) before 
sending any alphatext to the terminal . That way, if the 
terminal is a 4114 rather than a 4112, the (US) character 
causes the terminal to resume normal processing of the 
characters it receives. 
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Disk and 3PPI Hardware Errors 

For some disk system (Option 42 or 43) or Three Port 
Peripheral Interface (Option 10) errors, the error message 
reports a "hardware error number." Table C-1 lists the disk 
and 3PPI hardware errors: 

Table C-1 



DISK AND 3PPI HARDWARE ERRORS 



error jNumDer 


Explanation 


1 


Disk: 


Cannot complete result phase . 


2 


Disk: 


Cannot sense drive status. 


3 


Disk: 


Cannot sense interrupt status. 


4 


Disk: 


RQM wrong state . 


5 


Disk: 


(Reserved . ) 


6 


Disk: 


(Reserved . ) 


7 


Disk: 


Invalid command . 


8 


Disk: 


Bad track. 


9 


Disk: 


Control mark. 


10 


Disk: 


CRC (cyclic redundancy check) error . 


11 


Disk: 


Missing address data . 


12 


Disk: 


Missing address mark. 


13 


Disk: 


No data. 


14 


Disk: 


Wrong cylinder . 


15 


Disk: 


Overrun . 


16 


Disk: 


(Reserved . ) 


17 


Disk: 


Not two-sided . 


18 


Disk: 


Failed command phase (bytes not output) . 


33 


3PPI: 


Circular buffer overrun . 


34 


3PPI: 


8250 data overrun . 


35 


3PPI: 


Errors 33 and 34. 


36 


3PPI: 


8250 parity error. 


37 


3PPI: 


Errors 33 and 36. 


38 


3PPI: 


Errors 34 and 36. 


39 


3PPI: 


Errors 33, 34, and 36. 


40 


3PPI: 


8250 framing error . 


41 


3PPI: 


Errors 33 and 40. 


42 


3PPI: 


Errors 34 and 40. 


43 


3PPI: 


Errors 33, 34, and 40. 


44 


3PPI: 


Errors 36 and 40. 


45 


3PPI: 


Errors 33, 36, and 40. 


46 


3PPI: 


Errors 34, 36, and 40. 


47 


3PPI: 


Errors 33, 34, 36, and 40. 
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Disk System Context Errors 

For some disk system errors ( "type 3" errors such as JC 13, 
JC33, JD33, etc.), a supplemental error message may be 
displayed . This supplemental message describes the type of 
"context error" which has occurred. Table A-2 lists these 
context error types: 

Table -C-2 
DISK SYSTEM CONTEXT ERROR 
Error Explanation 

File Already Open Tried to open for input a file 

which is already open for out- 
put ; or , tried to open for 
output a file which is already 
open for input . 

No FCB No File Control Block is 

available when opening a file ; 
or, the File Control Block has 
been destroyed . 

Secure Volume A "secure volume" is a disk- 

ette (usually holding proprie- 
ty software) which cannot be 
copied . (However, files can be 
<load>ed from a secure volume, 
and a directory can be ob- 
tained with the <directory> 
command. 

Directory Full This diskette already contains 

the maximum number of files 
for which it was formatted. 

File Not Open Tried to close a file which is 

not currently open . 

File Trailer Error Unsuccessful attempt to termi- 

nate the writing of a file. 
(The file being written be- 
comes inaccessible . ) 
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Directory Update Error 



Error in attempting to update 
the disk directory on the 
diskette . 



Transfer Direction Error Tried to read from a file 



which was opened for output; 
or, tried to write to a file 
which was opened for input. 
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(For several GIN commands. ) 



1002 (Level 2): Insufficient memory available for GIN functions. 

1011 (Level 2): Invalid device-function code. (See the description of 

the <enable-GIN> command for a table of device-function 
codes.) 

I 1 <Enable-4953-Tablet-GIN> 

<Disable-4953-Tablet-GIN> (ESC) (I ) ( ! ) <ASCII-ehar> 

1 100 (Level 2): Unrecognized command (Option 13 or 14 not installed). 

IA <Set-Pick-Aperture> r (ESC) (I) (A)<int> 

IA11 (Level 1): Invalid aperture width (must be in the range from to 
4095). 

IC <Set-GIN-Cursor> = (ESC) (I ) (C)<intXint> 

IC 13 (Level 2): Graphic input has already been enabled for the specified 
device-function code . 

IC20 (Level 2): Segment does not exist , or is currently being defined . 



IC21 (Level 2) : Invalid segment number (must be in the range to 
32767) . 
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IE <Enable-GIN> = (ESC) (I) (E)<intXint+> 

1011 (Level 2): Invalid device-function code. 

IE00 (Level 2): The cursor segment for the specified device-function 
code does not exist. (It has been deleted after the 
<set-GIN-cursor> command which assigned it to that de- 
vice-function code . ) 

IE03 (Level 2) : Command is invalid at this time. (The segment being used 
as the cursor for the specified device-function code is 
a segment which is currently being defined . ) 

IE 10 (Level 2) : The specified GIN device is not installed in the 
terminal . 

IE 13 (Level 2): The*BB specified GIN device is invalid at this time, or 
the terminal runs out of memory while initializing for 
graphic input . A GIN device is "invalid at this time" if 
it is busy, if it is already enabled for GIN, or if it 
is a peripheral port to which a plotter protocol has not 
been <port-assign>ed .*EB 

IE21 (Level 2) : Invalid number of GIN events . (Must be in the range from 
to 65535.) 

IF <Set~GIN~Stroke~Filtering> = (ESC) (I) (F)<intXintXint> 
101 1 (Level 2): Invalid number of GIN events. 

IF00 (Level 2): Unrecognized command . (The tablet option is not in- 
stalled . ) 

IF 10 (Level 2) : Stroke filtering does not apply to the specified device- 
function code . (Stroke filtering applies only to the 
stroke function on the tablet device . ) 

IF21 (Level 2) : Invalid filtering distance . (Must be in the range from 

to 4095.) 

IF31 (Level 2) : Invalid filtering time . (Must be in the range from to 

32767.) 
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IG <Set-GIN-Gridding> r (ESC) (I ) (G)<intXintXint> 

IG10 (Level 2): Gridding does not apply to the specified device-function 
code. (Gridding is not allowed for the stroke function,) 

IG21 (Level 2): Invalid x-spacing (must be in the range from to 4095). 

IG31 (Level 2): Invalid y-spacing (must be in the range from to 4095). 

IH <Set-Tablet-Header-Characters> = (ESC) (I) (H)<int> 

IH00 (Level 0): Unrecognized command. (Tablet option is not installed.) 

IH 1 1 (Level 2) : Invalid parameter. (Must be or 1 ; in SETUP mode, must 
be CONTROL or LETTERS.) 

II <Set-GIN-Inking> =(ESC) (I) (I)<intXint> 

101 1 (Level 2) : Invalid device-function code . (See the description of 

the <enable-GIN> command for a table of device-function 
codes. ) 

1110 (Level 2) : Inking does not apply to the specified device-function 
code . (Inking is not allowed for the pick function . ) 

1121 (Level 2) : Invalid inking mode (must be or 1 ) . 

IL <Set-Report-Max~Line-Length> = (ESC) (I)(L)<int> 

IL 1 1 (Level 2) : Invalid maximum report line length. (Must be in the 
range from to 65535.) 

IM <Set-Report-E0M-Frequency> = (ESC) (I)(M)<int> 

IM1 1 (Level 2) : Invalid report-EOM-frequency setting (must be or 1 ) . 
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IP <Report-GIN~Point> = (ESC) (I)(P)<int> 

1011 (Level 2) : Invalid device-function code. (See the description of 
the <enable~GIN> command for a list of valid device- 
function codes,) 

IE10 (Level 2): The specified GIN device is not installed in the 
terminal, 

IP 1 3 (Level 2): The device-function code names a device which has 
already been enabled for a different graphic input 
function . 

IQ <Report-Terminal~Settings> = (ESC ) ( I ) ( Q ) <char Xchar > 

No errors are detected for this command. 

IR <Set-GIN-Rubberbanding> = (ESC) (I)(R)<intXint> 

1011 (Level 2): Invalid device-function code, (See the <enable-GIN> 
command for a table of device-function codes.) 

IR 10 (Level 2): Rubberbanding does not apply to the specified device- 
function code. (Rubberbanding is only allowed for the 
locator function. It is forbidden for the pick and 
stroke functions.) 

IR21 (Level 2): Invalid rubberbanding mode (must be or 1 ) . 

IS <Set-Report-Sig-Chars> = (ESC) (I ) (S)<intXintXint> 

1011 (Level 2): Invalid report type code. (Must be a valid device- 
function code, or in the range from -1 to -3. ) 

IS21 (Level 2): Invalid second parameter. (Must be in the range from 
to 127) . 

IS31 (Level 2): Invalid third parameter. (Must be in the range from to 
127.) 

IT <Set-Tablet-Status-Strap> = (ESC) (I) (T)<int> 

IT00 (Level 0): Unrecognized command. (The tablet option is not in- 
stalled . ) 

IT 1 1 (Level 2): Invalid strap setting (must be or 1 ) . 
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JO and J1 : Disk System Errors on Power-Up 

J002 (Level 3)» Memory error detected by standard firmware. 

J 102 (Level 3) : Memory error detected by optional peripheral firmware. 

J 109 (Level 3) : Hardware initialization error in disk controller board. 

JB <Activate-LPOS> » (lSS)(j)(l) 

JB00(Level 0): Unrecognized command (Option 42 3 version 3 
©r later not installed)* 

JB00(Level 2) : 1 LPS . SYS ' is not found on disk in drive FO: . 

JB02(Level 3 ) : Out of memory while activating local pro- 
grammability • 

-JB03(Level 2 ) : Context error (local programmabili ty already 
active) . 

JB09(Level 2 ) : Disk hardware error ( drive not ready , I 

error) * 
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JC <Copy> = (ESC) ( J) (C) <string><string><string> 

JCOl(Level 2) 



JC03 (Level 2 

JC10 (Level 2 

JC11 (Level 2 

JC12 (Level 3 

JC13 (Level 2 

JC19 (Level 2 

JC21 (Level 2 

JC22 (Level 3 

JC30 (Level 2 

JC31 (Level 2 

JC32 (Level 3 

JC33 (Level 2 

JC39 (Level 2 



Data cannot be formatted for copier by HC : 
(Option 9 only) • 

Attempt to copy an entire disk volume onto itself (e.g . , 
a copy from FO: to FO: ) . 

Specified source device does not exist . 

Invalid source device specifier . 

Parameter 1 memory error . (Out of memory while parsing 
the first parameter , or while executing the command . ) 

Parameter 1 context error (not an input device , or 
device is busy) . 

Disk hardware error or drive not ready on the source 
disk drive. 

Invalid separator string (must be empty string or "TO") . 

Parameter 2 memory error . (Out of memory while parsing 
the separator string. ) 

Specified destination device does not exist. 
Invalid destination specifier . 

Parameter 3 memory error . (Out of memory while parsing 
the third parameter, or while executing the command . ) 

Parameter 3 context error. (Invalid destination device, 
or device is busy . ) 

Disk hardware error or drive not ready on the 
destination disk drive. 
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JE <Stop-Spooling> = (ESC)(I)(T) 

No errors are detected for this command. 

JD <Directory> = (ESC) ( J) (D)<stringXstringXstring> 

JDOO (Level 2): Unrecognized command. (Disk drive option is not in- 
stalled.) 

JD10 (Level 2): The device for which the directory is requested does not 
exist. 

JD11 (Level 2) : Invalid input device specifier in parameter 1 . 

JD12 (Level 3) : Parameter 1 memory error . (Out of memory while parsing 
the source string, or while executing the command . ) 

JD13 (Level 2) : Context error in parameter 1 . (The specified device is 
not a disk drive, or failed reading bit map. ) 

JD19 (Level 2) : Disk hardware error (or drive not ready) for the disk 
drive whose directory is being requested . 

JD21 (Level 2): Invalid separator string (must be empty string or "TO") . 

JD22 (Level 3) Parameter 2 memory error . (Out of memory while parsing 
the separator string . ) 

JD30 (Level 2) : The specified destination device does not exist. 

JD31 (Level 2) : Invalid destination device specifier , 

JD32 (Level 3) • Parameter 3 memory error . (Out of memory while parsing 

the destination string , or while executing the command . ) 

JD33 (Level 2) : Parameter 3 context error. (The device specified is not 
a valid destination device, or is write-protected . ) 

JD39 (Level 2) : Disk hardware error for the destination device. (I/O 
error , write-protect error , or disk drive not ready.) 
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JF <Format-Volume> = (ESC) ( J ) (F) <string><int> 

JFOO (Level 2) : Unrecognized command. (Disk drive option not installed . ) 
JF10 (Level 2): Device does not exist or is not installed . 
JF11 (Level 2) : Invalid device specifier . 

JF12 (Level 3) : Parameter 1 memory error . (Out of memory while parsing 
the device specifier string. ) 

JF13 (Level 2) : The device specified in parameter 1 (a) is not a disk 

drive, (b) is write-protected , (c) is busy, (d) detects 
a verify error , or (e) detects a bit map error. 

JF19 (Level 2) : Hardware error at the specified disk drive. (Format 

error , drive not ready, or write-protect switch or notch 
error . ) 

JK <Delete-File> = (ESC) (J) (K)<string> 

JKOO (Level 2): Unrecognized command . (Disk drive option is not in- 
stalled . ) 

JK10 (Level 2) : The specified file or disk drive does not exist . 
JK11 (Level 2) : Invalid device specifier. 

JK12 (Level 3) : Parameter 1 memory error . (Out of memory while parsing 
parameter 1 . ) 

JK13 (Level 2) : The specified device (a) is not a disk drive, (b)is 
write-protected , or (c) detects a bit map error . 

JK19 (Level 2) : Disk hardware error . (I/O error , drive not ready, or 
hardware write-protect error . ) 
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JL <Load> r (ESC)(J)(L)<string> 

JL02 (Level 3) *. Out of memory while performing <load> command. 

JL03 (Level 2): Nesting error . (<Load> commands are nested too deeply.) 

JL10 (Level 2): File or device does not exist . 

JL1 1 (Level 2): Invalid file specifier. 

JL12 (Level 3)« Parameter 1 memory error . (Out of memory while parsing 
parameter 1 , or while executing the command . ) 

JL13 (Level 2): Context error in parameter 1, (Not a valid source 
device . ) 

JL 19 (Level 2) : Disk hardware error or drive not ready, 
JP <Protect-File> - (ESC) ( J ) (P ) <string><int> 

JPOO (Level 2): Unrecognized command, (Disk drive option is not in- 
stalled . ) 

JP10 (Level 2): The specified file or disk drive does not exist. 
JP11 (Level 2): Invalid file specifier, 

JP12 (Level 3): Parameter 1 memory error, (Out of memory while parsing 
parameter 1 , ) 

JP 13 (Level 2): Either the specified device is not a disk drive, or the 
file (or -entire diskette volume) has been write- 
protected . 

JP19 (Level 2): Disk hardware error, (I/O error, drive not ready, or 
hardware write-protect error,) 

JP21 (Level 2): Invalid protection mode (must be or 1 ) . 
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JQ <Report-Device^Status> - (ESC) (J) (Q)<string> 
JQOO (Level 2 



JQ10 (Level 2 

JQ11 (Level 2 

JQ12 (Level 3 

JR <Rename 

JROO (Level 2 

JR10 (Level 2 

JR11 (Level 2 

JR12 (Level 3 

JR13 (Level 2 

JR19 (Level 2 

JR21 (Level 2 

JR22 (Level 3 

JR30 (Level 2 

JR31 (Level 2 

JR32 (Level 3 



Unrecognized command . (Disk drive option is not in- 
stalled,) 

Device does not exist or is not installed. 
Invalid device specifier. 

Parameter 1 memory error, (Out of memory while parsing 
parameter 1.) 

-File> = (ESC)(J)(R)<stringXstringXstring> 

Unrecognized command. (Disk drive option is not in- 
stalled.) 

The specified device or file does not exist. 
Invalid "old" file specifier. 

Parameter 1 memory error. (Out of memory while parsing 
parameter 1 . ) 

Either the device specified in parameter 1 is not a disk 
drive, or the file (or entire diskette) has been write- 
protected . 

Disk hardware error. (I/O error, drive not ready, or 
hardware write-protect error.) 

Invalid separator string (must be empty string or "TO"). 

Parameter 2 memory error. (Out of memory while parsing 
parameter 2. ) 

Either the device specified in parameter 3 does not 
exist, or the "new" filename already is in use. 

Invalid device specifier in parameter 3. 

Parameter 3 memory error. (Out of memory while parsing 
parameter 3. ) 
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JS <Spool> = (ESC) ( J) (S)<string><string><string> 

JS01 (Level 2 ) : Data cannot be formatted for copier by HC : 

( Option 9 only) . 

JS03 (Level 2): Command context error™ (A spooling operation is already 
in progress.) 

JS10 (Level 2): Specified source device does not exist, 

JS11 (Level 2): Invalid source specifier, (Must be "HO:" f "PO:", "P1:" f 
"P2: f \ or a file specifier such as "FO: FILENAME" . Speci- 
fying only the disk drive — such as "FO:" or "F1:" — 
is not allowed. ) 

JS12 (Level 3) : Parameter 1 memory error . (Out of memory while parsing 
parameter 1 , or while executing the command . ) 

JS13 (Level 2) : Parameter 3 context error . (Not a valid input device. ) 

JS19 (Level 2) : Disk hardware error or drive not ready on the source 
disk drive. 

JS21 (Level 2) : Invalid separator string (must be empty string or "TO") . 

JS22 (Level 3) : Parameter 2 memory error. (Out of memory while parsing 
parameter 2. ) 

JS30 (Level 2) : Specified destination device does not exist. 

JS31 (Level 2) : Invalid destination device specifier. 

JS32 (Level 3) : Parameter 3 memory error. (Out of memory while parsing 
parameter 3, or while executing the command . ) 

JS33 (Level 2) : Parameter 3 context error. (Not a valid destination 
device.) 

JS39 (Level 2) : Disk hardware error or drive not ready on the 
destination disk drive. 
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JV <Save> = (ESC)(J)(V)<stringXint><stringXstring> 

JV11 (Level 2): Invalid type-of-save string, (Must be MAC, SEG, RAS, or 
RUN. The latter two codes are valid only for the 4112 
terminal . ) 

JV12 (Level 3) • Parameter 1 memory error . (Out of memory while parsing 
parameter 1, or while executing the command . ) 

JV20 (Level 2) : The specified macro definition or segment does not 
exist. 

JV21 (Level 2) : Invalid item number or count. 

JV31 (Level 2) : Invalid separator string (must be empty string or "TO") . 

JV32 (Level 3) : Parameter 3 memory error . (Out of memory while parsing 
the separator string.) 

JV40 (Level 2): The specified destination device does not exist. 

JV41 (Level 2) : Invalid destination device specifier . 

JV42 (Level 3) : Parameter 4 memory error . (Out of memory while parsing 

the destination string , or while executing the command . ) 

JV43 (Level 2) : Parameter 4 context error. (Not a valid destination 
device, or device is busy. ) 

JV49 (Level 2) : Disk hardware error on destination disk drive. (I/O 
error , drive not ready, or hardware write-protect 
error . ) 

KO : Keyboard System Errors 

KO (Level 3) : Out of memory while initializing the keyboard system. 

KA <Enable-Dialog-Area> r (ESC) (K) (A)<int> 

KA11 (Level 2) : Parameter out of range (must be or 1). 

KC <Cancel> = (ESC)(K)(C) 

No errors are detected for this command . 
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KD <Define-Macro> = (ESC) (K) (D)<intXint-array> 

KD1 1 (Level 2 ) : Invalid macro number (must be in range 

-32768 through -33742, -32740 through 
. -32737, -32608 through -32513, or -1 to 
32767) • 

KD21 (Level 2 V ) :■■ Invalid character-code in <int-array> - .. 

(length must be from through 65535 , < in t > 
values must be in range from through 127)* 

KD22 (Level 3): Insufficient memory to define macro - 
EE . <Echo> - (ESC)(K)(E)<int> 

KE 1 1 (Level 2) : Invalid echo mode (must be or 1 ) . * 
KF <LFCR> = (ESC)(K)(F)<int> 

KF11 (Level 2): Invalid LFCR mode (must be or 1) . 
KH <Hardcopy> = (ESC) (K) (H)<int> 

KH01 ( Level 2 ) : Copier fault condition ; operator assistance 

required (Option 9 only)* 

KH 1 1 (Level 2) : Invalid hard copy code (must be 0, 1 , or 2) . 

II <Ignore-Deletes> = (ESC) (K)(I)<int> 

KI 1 1 (Level 2 ) : Invalid ignore-deletes mode (must be or 1). 

IL <Lock-Keyboard> = (ESC) (K) (L)<int> 

KL1 1 (Level 2): Invalid keyboard-lock mode (must be or 1 ) . 

KM <Set-MarginB> « (ESC) (K)(M)<int> 

KMOO (Level 0): Unrecognized command . (The terminal is not a 4114. ) 

KM1 1 (Level 2): Invalid number of margins (must be in the range from 1 
to 8). 
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KN <Renew-View> = (ESC) (K)(N)<int> 

KN02 (Level 3): Out of memory while attempting to renew a view. (This 
error can also occur as a result of pressing the PAGE 
key J 

KN10 (Level 2): The view specified does not exist, 

KN11 (Level 2): Parameter out of range (must be in the range from -32768 
to +32767). This parameter should be in the range from 
-1 to 64; however, the terminal will substitute -1 in 
place of a value which is less than -1, and +64 in place 
of a value which is greater than +64. 

KP <Set-Page~Full-Action> = (ESC) (K) (P)<int> 

KP1 1 (Level 2) : Invalid page-full-action code, (Must be in the range 
from to 7.) 

KQ <Report-Errors> = (ESC)(K)(Q) 

No errors are detected for this command . 

KR <CRLF> = (ESC)(K)(R)<int> 

KR1 1 (Level 2): Invalid "CR-implies-LF" mode (must be or 1). 

KS <Snoopy> = (ESC) (K) (S)<int> 

KS1 1 (Level 2) : Invalid parameter (must be or 1 ) 

KT <Set-Error-Threshold> = (ESC) (K) (T)<int> 

KT1 1 (Level 2): Invalid error threshold (must be in range from to 4) . 

IV <Reset> = (ESC)(K)(V) 

No errors are detected for this command . 
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KX <Expand-Macro> = (ESC) (K) (X)<int> 

KX01 (Level 2): The maximum nesting depth (for <expand-macro> and <load> 
commands) has been exceeded . (The nesting depth should 
not exceed five. Greater nesting depths may result — 
but do not necessarily result ~ in type KX01 errors. ) 

KX02 (Level 3) : Out of memory while performing <expand-macro> command . 

KX1 1 (Level 2): Invalid macro identifier (must be in the range from to 
32767). 

KY <Set-Key-Execute-Char> = (ESC) (K) (Y)<int> 

KY1 1 (Level 2) : Invalid <key-execute-delimiter> code (must be in range 
to 127). 

KZ <Set-Edit-Chars> = (ESC) (K ) (Z)<intXintXint> 

KZ11 (Level 2) : Invalid char-delete character (must be in the range from 
to 127). 

KZ21 (Level 2) : Invalid line-delete character (must be in the range from 
to 127). 

KZ31 (Level 2) : Invalid take-literally character (must be in the range 
from to 127). 

LB <Set-Dialog-Area-Buffer-Size> = (ESC) (L) (B)<int+> 

LB1 1 (Level 2) : Invalid number-of-lines parameter . (Must be in the range 

from 2 to 32767.) 

LC <Set-Dialog-Area-Chars> = (ESC) (L) (C)<int+> 

LC11 (Level 2) : Invalid number of characters per line . (In the 4112 and 

4113, this must be in the range from 5 to 80. In the 

41 14, it must be in the range from 5 to 819. ) 
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LE <End-Panel> = (ESC)(L)(E) 

LEOO (Level 0): Unrecognized command, (The terminal is not a 4112 or a 
4113). 

LE03 (Level 1): No panel is currently being defined. 

LE02 (Level 3) : Out of memory while performing <end-panel> command . 

LF <Move> = (ESC)(L)(F)<xy> 

No errors are detected for this command . 

LG <Draw> = (ESC) (L) (G)<xy> 

No errors are detected for this command . 

LH <Draw-Marker> = (ESC) (L) (H)<xy> 

No errors are detected for this command . 

LI <Set-Dialog-Area-Index> = (ESC) (L) (I)<int+Xint+Xint+> 

LI00 (Level 0) : Unrecognized command . (The terminal is not a 4 1 12 or a 
4113.) 

L1 1 1 (Level 2): Invalid character index . (Must be in the range from to 
65535.) 

LI21 (Level 2) : Invalid character background index . (Must be in the 
range from to 65535. ) 

LI31 (Level 2) : Invalid dialog area wipe index . (Must be in the range 
from to 65535. ) 

LK <Include~Copy-of-Segment> = (ESC) (L)(K)<int> 

LK02 (Level 3): Out of memory while performing <include-copy-of-seg- 
ment>. 

LK10 (Level 2) : Segment does not exist. 

LK11 (Level 2) : Invalid segment number (must be -3, -1, or in the range 
from 1 to 32767.) 

LK13 (Level 2): The segment specified is currently being defined . 
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LL <SetBiaiog^Area-Lines> = (ESC) (L)(L)<int+> 

LL11 (Level 2): Invalid parameter* (In the 4112 and 4113, must be in the 
range from 2 to 34. In the 4114, must be in the range 
from 2 to - 520..) 

LM <SetrDtaio$-Area^Writing^Mo.de * (ESC) (L) (M)<int> 

LM1 1 (Level 2): Invalid writing mode (must be or 1). 

LP <Begin-Panel~Boundary> s (ESC) (L) CP)<xyXint> 

LP00 (Level 0): Unrecognized command . (Terminal is not a 4112 or a 
4113.) 

LP03 (Level 2) : Alphatext is not allowed within a <panel-definition>. 

(When this error is detected, the panel being defined is 
closed , as if an <end-panel> command had been received .* 
EB) 

LP21 (Level 2): Invalid "draw border" mode (must be or 1 ) . 
LS <Set~Dialog-Area-Surface> = (ESC) (L) (S)<int> 

LS00 (Level 0) : Unrecognized command . (The terminal is not a 4112 or a 
4113.) 

LS1 1 (Level 2) : Invalid surface number . (In the 4112, must be 1, 2, or 
3; in the 4113, must be 1, 2, 3, or 4. ) 

LT <Graphic-Text> s (ESC) (L) (T)<string> 

LT03 (Level 2): Command is invalid at this time: graphtext is not 

allowed within a <panel-def inition>.*BB (When this error 
is detected , the panel being defined is closed , as if an 
<end-panel>. command were received-. )-*EB 

LT1 1 (Level 2): -Invalid graphtext string. Invalid array count (must be 
in range from to 32767), or invalid <char> character 
in the array (must be in the range from (SP) to (~) ~ 
decimal equivalents from 32 to 126). 

LT12 (Level 3). Parameter 1 memory error ■. (Out of memory while parsing 
the <string> parameter . ) 
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LV <Set-Dialog-Area-Visibility> = (ESC) (L)(V)<int> 

LV03 (Level 0): One or more of the dialog area parameters was altered 
when the dialog area was made visible. 

LV11 (Level 2): Invalid dialog area visibility mode. (Must be or 1 ; in 
SETUP mode, must be YES or NO.) 

LX <Set-Dialog-Area-Position> = (ESC) (L) (X)<xy> 

No errors are detected for this command. 

LZ <Clear-Dialog-Scroll> = (ESC)(L)(Z) 

No errors are detected for this command. 

MB <Set-Background-Indices> = (ESC) (M) (B)<int+Xint+> 

MBOO (Level ) : Unrecognized command ( terminal is not a 4112 

or 4113). 

MB 11 (Level 2): Invalid text-background-index (must be in the range from 
-2 to +32767). 

MB21 (Level 2): Invalid line-gap-index (must be in the range from -2 to 
+32767). 

HC <Set-Graphtext-Size> = (ESC) (M) (C)<intXintXint> 

MC11 (Level 2): Invalid value in parameter 1. (Must be in the range from 
1 to 4095.) 

MC21 (Level 2): Invalid value in parameter 2. (Must be in the range from 
1 to 4095.) 

MC31 (Level 2): Invalid value in parameter 3. (Must be in the range from 
to 4095.) 
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MD <Begin-Fill-Pattern> = ' (ESC) (M) (D)<intXint><intXint> 

MDOO (Level 0): Unrecognized command, (The terminal is not a 4112 or 
4113.) 

MD02 (Level 3): Not enough memory available for fill pattern, 

MD11 (Level 2): Invalid fill pattern number (must be in the range from 1 
to 32767) » 

MD21 (Level 2): Invalid pattern width. ( Must be in the range 1 to 32. 

Should be 1, 2, 4, 8, 16, or 32; other values do not 
necessarily give the desired results.) 

MD31 (Level 2): Invalid pattern height (must be in the range to 480). 

MD41 (Level 2): Invalid bits-per-pixel . (In the 4112, must be 1, 2, 3, 
or 6; in the 4113, must be 1, 2, 3, 4, or 6.) 

ME <End-Fill-Pattern> = (ESC)(M)(E) 

No errors are detected for this command. 

MF <Set-Graphtext-Font> = (ESC) (M) (F)<int> 

MF10 (Level 2): Font does not exist. 

MF 1 1 (Level 2): Invalid font number (must be in the range from to 
32767). 

MG <Set-Graphics-Area-Writing-Mode> = (ESC) (M) (G)<int> 

MG00 (Level 2) : Unrecognized command. (Terminal is not a 4112 or a 
4113.) 

MG11 (Level 2): Invalid parameter. (Must be or 1 ; in SETUP mode, must 
be OVERSTRIKE or REPLACE.) 

MI <Set-Pick-ID> = (ESC) (M) (I)<int> 

MI03 (Level 2): Command is invalid at this time. (No segment is current- 
ly being defined.) 

M1 11 (Level 2): Invalid pick identification number. (Must be in the 
range from to 32767 J 
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ML <Set-Line-Index> = (ESC) (M) (L)<int+> 

ML11 (Level 2): Invalid line index. (Must be in the range from to 
32767.) 

MM <Set-Marker-Type> = (ESC) (M) (M)<int> 

MM11 (Level 2): Invalid marker type (must be in the range from to 10). 
MP <Select-Fill-Pattern> = (ESC) (M) (P)<int> 

MP00 (Level 2): Unrecognized command. (The terminal is not a 4112 or a 
4113.) 

MP10 (Level 2): Specified fill pattern does not exist (has not been 
defined) . 

MP11 (Level 2): Invalid fill pattern number (must be in the range from 
-32768 to 32767.) 

MQ <Set-Graphtext-Precision> = (ESC) (M) (Q)<int> 

MQ11 (Level 2): Invalid precision mode (must be 1 or 2). 

MR <Set-Graphtext-Rotation> = (ESC) (M) (R)<real> 

MR11 (Level 2): Invalid rotation angle (must be in the range from 
-32767.0 to +32767.0). 
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MS <Set-Panel-Filling-Mode> = (ESC) (M) (S)<intXintXint> 

MSOO (Level 2) : Unrecognized command. (Terminal is not a 
4112 or a 4113.) 

MS11 (Level 2): Invalid over strike/replace mode parameter . 
(must be or 1), 

MS21 (Level 2): Invalid boundary-filling mode parameter 
(must be or 1 ) • 

MS31 (Level 2) : Invalid pattern keying value (must be f 1 f 
2, or 3). 

MT <Set-Text~Index> - (ESC) (M) (T)<int+> 

MT11 (Level 2): Invalid text index . (Must be in the range 
from to 65535 J 

MV <Set-Line-Style> = (ESC) (M) (V)<int> 

MV11 (Level 2): Invalid line style. (Must be in the range 
from to 7.) 

NW <Set-Line-Width> r (ESC) (M) (W)<int> 

MWOO (Level 0): Unrecognized command. (The terminal is not a 
4114 J 

MW1 1 (Level 2): Invalid line width, (Must be either or 1 . ) 

MY <S*lect~Alphatext-Sise-Group> • (BSC) (M) (Y)<iat> 

MYOO (Level ) : Unrecognized command (terminal is not a 

4114). 

MI1 1 (Level 2): Invalid value (must be either or 1 ) • 

MZ <Set-Alphatext-Size> = (ESC) (M) (Z)<intXintXint> 

MZ00 (Level 0): Unrecognized command . (Terminal is not a 
4114.) 

MZ11 (Level 2): Invalid size multiplier (must be in the 

range from 1 to 16) . 

MZ21 (Level 2): Invalid inter-character spacing (must be in 
the range from to 15) . 

MZ31 (Level 2) : Invalid inter-line spacing (must be in the 
range from to 255). 
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MB <Set-Stop-Bits> = (ESC) (N ) (B)<int> 

NB1 1 (Level 2): Invalid number of stop bits (must be 1 or 

NC <Set-EOM-Chars> = (ESC) (N ) (C)<intXint> 

NC1 1 (Level 2): Invalid value in parameter 1. (Must be in 
the range from to 127.) 

NC21 (Level 2): Invalid value in parameter 2. (Must be in 
the range from to 127. ) 

ND <Set~Transmit-Delay> = (ESC) (N) (D)<int> 

ND1 1 (Level 2) : Invalid transmit delay time. (Must be in the 
range from to 65535 milliseconds. ) 

NE <Set-EOF~String> = (ESC) (N) (E)<int-array> 

NE11 (Level 2) : Invalid EOF-string (must contain from to 
10 characters, with each character repre- 
sented by an <int> in the range from to 
127). 

NE12 (Level 3) I Parameter 1 memory error . (Out of memory 
while parsing the <int-array> parameter . ) 

NF <Set-Flagging-Mode> = (ESC) (N)(F)<int> 

NF1 1 (Level 2) : Invalid flagging mode (must be in the range 
from to 4) . 

MK <Set-Break-Time> = (ESC) (N) (K)<int+> 

NK1 1 (Level 2) : Invalid parameter . (Must be in the range 
from to 65535. ) 

NL <Set-Transmit-Rate-Limit> - (ESC) (N) (L)<int+> 

NL 1 1 (Level 2): Invalid transmit rate limit . (Must be in the 
range from 1 10 to 65535. ) 
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NM <Prompt-Mode> = (ESC) (N)(M)<int> 

NM11 (Level 2): Invalid prompt mode parameter (must be 0, 
1,or 2). 



HP <Set-Parity> = (ESC) (N) (P)<int> 

NP11 (Level 2): Invalid parity code. (Must be in the range 
from to 4.) 

NQ <Set-Queue-Size> = (ESC) (N) (Q)<int+> 

NQ02 (Level 3): Out of memory while performing <set-queue- 
size> command . 

NQ11 (Level 2): Invalid queue size. (Must be in the range 
from 1 to 65535.) 

NR <Set-Baud-Rates> = (ESC) (N)(R)<int+Xint+> 

NR11 (Level 2): Invalid transmit ( terminal-to-host) data 
rate. (Must be 1, 50, 75, 110, 134, 150, 
300, 600, 1200, 1200, 1800, 2000, 2400, 
4800, 9600, 19200, or 38400.) 

NR21 (Level 2): Invalid receive (host-to-terminal) data 

rate. (Must be 0, 1, 50, 75, 110, 134, 150, 
300, 600, 1200, 1800, 2000, 2400, 4800, 
9600, 19200, or 38400.) 

NS <Set-Prompt-String> = (ESC) (N) (S)<int-array> 

NS1 1 (Level 2): Invalid <int-array> parameter . (Must be an 
array holding from to 10 <int> parameters. 
Each of the items in the array must be an 
<int> in the range from to 127. ) 

NS12 (Level 3): Parameter 1 memory error . (Out of memory 
while parsing the <int-array>. ) 
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NT <Set-Term-String> = (ESC) (N) (T)<int-array> 

NT11 (Level 2): Invalid array count in <int-array>. (The 
array must hold from to 2 <int> parame- 
ters . Each <int> in the array must be in the 
range from to 127. ) 

NT12 (Level 3) : Parameter 1 memory error. (Out of memory 
while parsing the <int-array> parameter.) 

NU <Set-Bypass-Cancel-Char> = (ESC) (N) (U)<int> 

NU11 (Level 2): Invalid numeric equivalent of bypass-cancel 
character. (Must be in the range from to 
127.) 



OB <Arm-For-Block-Mode> = (ESC) (0) (B)<Int> 

OB00 (Level 2): Unrecognized command. (Option 01 is not 
installed.) 

0B03 (Level 2) : The communications queue size is smaller 
than the specified input block size. 

0B11 (Level 2): Invalid "arm-for-block-mode" parameter (must 
be or 1 ) . 

OC <Set-Block-Continue-Chars> = (ESC) (0) (C)<intXint> 

0C00 (Level 2) : Unrecognized command . (Option 01 is not 
installed . ) 

OC03 (Level 2) : Command is invalid at this time. (Terminal 

must not be in block mode or armed for block 
mode . ) 

0C1 1 (Level 2) : Invalid first parameter . (Must be in the 
range from to 127. ) 

0C21 (Level 2) : Invalid second parameter . (Must be in the 
range from to 127. ) 
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OD <Set-Duplex-Mode> = (ESC) (0) (D)<int> 

ODOO (Level 2); Unrecognized command. (Option 01 is not 
installed.) 

0D01 (Level 2): Invalid duplex mode code (must be in range 
to 3). 

OE <Set~Block-End-Char s> = (ESC) (0) (E )<int><int> 

OE00 (Level 2): Unrecognized command, (Option 01 is not 
installed . ) 

OE03 (Level 2): Command invalid at this time* (Terminal must 
not be in block mode or armed for block 
mode,) 

OE 1 1 (Level 2) : Invalid first parameter. (Must be in the 
range from to 127. ) 

0E21 (Level 2) : Invalid second parameter . (Must be in the 
range from to 127. ) 
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OH <Set-Block-Headers> = (ESC) (0) (H)<int-array> 
<int- 

array> 

OHOO (Level 2): Unrecognized command, (Option 01 is not 
installed.) 

OH02 (Level 3): Out of memory while performing <set-block- 
headers> command, 

OH03 (Level 2): Command invalid at this time. (Terminal must 
not be in block mode or armed for block 
mode.) 



0H11 (Level 2): Invalid character code (0 to 127) or array 
count (must be in range to 10) in "trans- 
mit" (terminal-to-host) block header. 

0H12 (Level 3) : Parameter 1 memory error. (Out of memory 
while parsing the <int-array>. ) 

0H21 (Level 2) : Invalid character code (0 to 127) or array 
count (must be in range to 10) in "re- 
ceive" ( host-to-terminal ) block header . 

0H22 (Level 3) : Parameter 2 memory error . (Out of memory 
while parsing the <int-array>. ) 
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OL <Set-Block-Line-Length> = (ESC) (0) (L)<int> 

OLOO (Level 2): Unrecognized command. (Option 01 not 
installed.) 

OL03 (Level 2): Command invalid at this time. (Terminal must 
not be in block mode or armed for block 
mode.) 

0L11 (Level 2): Invalid maximum number of characters in 
line . (Must be in the range from 12 to 
65535.) 

0M <Set-Block-Master-Chars> = (ESC) (0) (M)<intXint> 

OM00 (Level 2) : Unrecognized command . (Option 01 is not 
installed . ) 

OM03 (Level 2) : Command invalid at this time. (Terminal must 
not be in block mode or armed for block 
mode. ) 

0M11 (Level 2) : Invalid "transmit" (terminal-to-host) master 
char code (0 to 127) . 

0M21 (Level 2) : Invalid "receive" ( host-to-terminal ) master 
char code (0 to 127) . 
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ON <Set-Block-Non-Xmt-Chars> = (ESC) (0) (N)<int-ar- 
rayXint-array> 

ONOO (Level 2): Unrecognized command. (Option 01 is not 
installed . ) 

ON03 (Level 2): Command invalid at this time. (Terminal must 
not be in block mode or armed for block 
mode.) 

ON 1 1 (Level 2) : Invalid character code or array count in 

list of terminal-to-host non-transmittable 
characters. (The array count must be in the 
range from to 20, and the character codes 
must be in the range from to 127. ) 

ON 12 (Level 3): Parameter 1 memory error. (Out of memory 
while parsing the <int-array>. ) 

ON 21 (Level 2) : Invalid character code or array count in 

list of host-to-terminal non-transmittable 
characters. (The array count must be in the 
range from to 20, and the character code 
must be in the range from to 127. ) 

ON 22 (Level 3) : Parameter 2 memory error . (Out of memory 
while parsing the <int-array>. ) 

OP <Set-Block-Packing> = (ESC) (0 ) (P ) <int><int><intXint> 

OP00 (Level 2) : Unrecognized command . (Option 01 is not 
installed . ) 

OP03 (Level 2) : Command invalid at this time. (Terminal must 

not be in block mode or armed for block 
mode . ) 

0P11 (Level 2) : Invalid terminal-to-host unpacked-bits-per- 
byte (must be 7 or 8). 

0P21 (Level 2) : Invalid terminal-to-host packed-bits-per- 
pseudo-byte (must be 6, 7, or 8). 

0P31 (Level 2) : Invalid host-to-terminal unpacked-bits-per- 
byte (must be 7 or 8). 

0P41 (Level 2) : Invalid host-to-terminal packed-bits-per- 
pseudo-byte (must be 6, 7, or 8). 
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OS <Set-Block-Length> = (ESC) (0) (S)<int+Xint+> . 

OSOO (Level 2): Unrecognized command . (Option 01 is not 
installed,) 

OS03 (Level 2): Command invalid at this time . (Terminal must 
not be in block mode or armed for block 
mode . ) 

0S11 (Level 2): Invalid terminal-to-host block length (must 
be in the range from 5 to 65535* ) 

0S21 (Level 2): Invalid host- to-terminal block length (must 
be in the range from 5 to 65535*) 



0T <Set-Block-Timeout> = (ESC) (0)(T)<int+> 

0T00 (Level 2): Unrecognized command . (Option 01 is not 

installed.) 

0T11 (Level 2) : Invalid timeout. (Must be in the range from 
to 65535. seconds. ) . . 
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PA <Port-Assign> = (ESC)(P)(A)<stringXstringXint> 

PAOO (Level 0): Unrecognized command. (Option 10 is not 
installed . ) 

PA11 (Level 2): Invalid port identifier. (Must be "P0:", 
"P1: f \ or "P2:".) 

PA 12 (Level 3)* Parameter 1 memory error . (Out of memory 
while parsing the port name <string>. ) 

PA13 (Level 3)* Port is in use, 

PA21 (Level 2): Invalid protocol identifier. (Must be 
"PPORT" , "4643", "4662", "4662/MP", 
"4662/NT", "4663", "4663/NB", or "4663/NT") 

PA22 (Level 3) * Parameter 2 memory error . (Out of memory 
while parsing the <string>. ) 



PB <Set-Port-Stop-Bits> = (ESC) (P ) (B) <string><int><int> 

PB00 (Level 0) : Unrecognized command . (Option 10 is not 
installed . ) 

PB1 1 (Level 2) : Port is busy, or port identifier is invalid 
(must be "P0:" f "P1: f \ or "P2:") . 

PB12 (Level 3) I Parameter 1 memory error . (Out of memory 
while parsing the port name <string> . ) 

PB21 (Level 2) : Invalid number of stop bits (must be 1 or 

2), 

PB31 (Level 2) : Invalid number of data bits (must be 5 , 6, 
7, or 8)o 
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PC <Port-Copy> = (ESC) (P) (C)<string> 

PCOO (Level 0) : Unrecognized command . (Option 10 is not 
installed) . 

PC02 (Level 2): Memory overflow caused by (ESC) (P)(C) com- 
mand . 

PC 11 (Level 2): Invalid "source" port (must be "HO:", "P0:", 
"P1:" f or "P2:") . 

PC 12 (Level 3) : Parameter 1 memory error . (Out of memory 

while parsing the source specifier string. ) 

PC 13 (Level 3): Source is busy. 

PC21 (Level 2) : Invalid separator string. (Must be the empty 
string or "TO".) 

PC22 (Level 3) : Parameter 2 memory error . (Out of memory 
while parsing the separator string . ) 

PC23 (Level 3)« Destination is busy. 

PC31 (Level 2) : Invalid "destination" port (must be "HO:" , 

"P0:" f "P1:" or "P2:", and must be different 
from the "source" port) . 

PC32 (Level 3): Parameter 3 memory error . (Out of memory 
while parsing the destination specifier.) 

PC 33 (Level 3) : Destination device is busy. 
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PE <Set-Port-EOF-String> = (ESC) (P) (E)<string> 
<int-array> 

PEOO (Level 0): Unrecognized command. (Option 10 is not 
installed) . 

PE11 (Level 2): Invalid port identifier (must be "P0: f! , 
"P1:", or "P2:") . 

PE 12 (Level 3 ) : Parameter 1 memory error . (Out of memory 
while parsing the the port name <string>. ) 

PE13 (Level 2): Port is busy. 

PE21 (Level 2) : Invalid EOF string. (The <int-array> must 
have from to 10 elements, and each <int> 
in the array must be in the range from to 

127.) 

PE22 (Level 3 ) : Parameter 2 memory error . (Out of memory 

while parsing the end-of-f ile string <int- 
array>. 
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PF <Set-Port-Flagging-Mode> = 
(ESC)(P)(F)<stringXint><intXint> 



PFOO (Level 0): Unrecognized command. (Option 10 is not 
installed.) 

PF11 (Level 2): Port is busy, or port identifier is invalid 
(must be "P0:", "P1:", or "P2:") . 

PF12 (Level 3) * Parameter 1 memory error . (Out of memory 
while parsing the port name <string>. ) 

PF21 (Level 2): Invalid flagging mode (must be 0, 1 or 2) . 

PF31 (Level 2) : Invalid "GO" character (must be in range 
to 127).' 



PF41 (Level 2): Invalid "STOP" character (must be in range 
to 127; if non-zero, must be different from 

the "GO" character) . 



PI <Map-Index-To-Pen> r (ESC) (P ) (I ) <string><int><int> 

PI00 (Level 0) : Unrecognized command • (Option 10 is not 
installed . ) 



PI02 (Level 3): No memory is available for the index map. 

(To guarantee an available index map for a 
particular peripheral port , the <map-index- 
to-pen> command should be issued immediately 
after power-up, or immediately after a <re- 
set> command . ) 



P1 1 1 (Level 2): Invalid port identifier (must be "P0:", "P1: 
", or "P2:") . 

P1 12 (Level 2) : Parameter 1 memory error . (Out of memory 
while parsing the port name string . ) 

P1 13 (Level 2): Port busy. 

PI21 (Level 2) : Invalid index (must be in the range from 
-1 to +255). 

PI31 (Level 2) : Invalid pen number (must be in the range 
from to 255). 
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PL <Plot> = (ESC) (P ) (L) <string><string> 

PLOO (Level 0): Unrecognized command . (Option 10 is not 
installed . ) 

PL 11 (Level 2): Invalid first parameter, (Must be the empty 
string or "TO".) 

PL 12 (Level 3 ) • Parameter 1 memory error, (Out of memory 
while parsing the <string> parameter . ) 

PL20 (Level 2) : Non-existent destination device ( if destina- 
tion specifier is of the form "F0: filename" 
or "F1 : filename" , then the corresponding 
disk drive must be installed . ) 

PL21 (Level 2) : Invalid output specifier (must be "HO: " , 

"P0:" f "P1:" f "P2:", "F0: filename" or "F1: 
filename") . 

PL22 (Level 3) : Parameter 2 memory error . (Out of memory 
while parsing the destination <string> . ) 

PL23 (Level 2): Parameter 2 context error . (Invalid destina- 
tion device , or device is busy . ) 

PM <Set-Port-EOL-String> = (ESC) (P) (M)<string><in't-ar- 

ray> 

PM00 (Level 0): Unrecognized command . (Option 10 is not 
installed . ) 

PM11 (Level 2): Invalid port identifier. (Must be "P0:", 
"P1:", or "P2:".) 

PM12 (Level 3) : Parameter 1 memory error . (Out of memory 
while parsing the port name <string>. ) 

PM13 (Level 2): Port is busy. 

PM22 (Level 3) : Parameter 2 memory error . (Out of memory 
while parsing the EOL-string <int-array>. ) 
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PP <Set-Port-Parity> = (ESC) (P) (P)<stringXint> 

PPOO (Level 0): Unrecognized command, (Option 10 is not 
installed) . 

PP11 (Level 2) : Invalid port specifier is invalid (must be 
"P0: f \ "P1:" f or f! P2:")» 

PP12 (Level 3) : Parameter 1 memory error . (Out of memory 
while parsing the port name <string>. ) 

PP13 (Level 2) : Port is busy. 

PP21 (Level 2) : Invalid parity code (must be in range to 

4). 

PQ <Report-Port-Status> = (ESC) (P) (Q)<string> 

PQ00 (Level 0) : Unrecognized command . (Option 10 is not 
installed) . 

PQ 1 1 (Level 2) : Invalid port identifier (must be "P0:", 
"P1:", or "P2:") . 

PQ12 (Level 3) Parameter 1 memory error . (Out of memory 
while parsing the port specifier string. ) 

PR <Set-Port-Baud-Rate> = (ESC) (P) (R) <string><int> 

PR00 (Level 0) : Unrecognized command . (Option 10 is not 
installed) . 

PR 11 (Level 2): Invalid port identifier (must be "P0: n , 
w P1: fl . f or "P2: lf K 

PR 12 (Level 3) : Parameter 1 memory error. (Out of memory 
while parsing the port name string . ) 

PR13 (Level 2) : Port is busy. 

PR21 (Level 2) : Invalid baud rate (must be 50, 75, 110, 134, 
150, 300, 600, 1200, 1800, 2000, 2400, 3600, 
4800, 7200, or 9600) . 
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QB <Set-Color«Copi®r~Data-Reaolution> • (ESC) (Q ) ( B) <int> 

QBOO (Level ) : Unrecognized command (Option 9 is not in- 
stalled) . 

QB11 (Level 2)2 <Int > parameter omitted or out of range (1 

and 2 are valid)* 

QD <Sel©ct-Hardcopy~Interfac©> « (BSC) (Q)(D)<int> 

QDOO (Level 0) : Unrecognized command ( Option 9 is not in- 
stalled ) . 

QD1 1 (Level 2 ) : <Int> parameter out f range (0 and 1 are 

valid ) » 

QI <Set-Huaber-Of-CopieB> -(ISC) (Q) (l)<iat*> 

QNOO (Level ) : Unrecognized command (Option 9 is not in- 
stalled ) • 

QN 1 1 (Level 2 ) : <Int + > parameter out f range (0 through 

65535 are valid ) . 

QO <Sat-Iaage-Orientation> « (BSC) (Q)(0)<int> 

Q000 (Level ) : Unrecognized command ( Option 9 is not 

ins tal led ) . 

QO 1 1 ( Level 2 ) : <Int > parameter out of range (0 through 3 

are valid ) . 

QQ <Report~Colorhardcopy-Statu8> * (ESC)(Q)(Q) 

QQOO (Level ) : Unrecognized command ( Option 9 is not in- 
stalled ) . 
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RA <Set-View-Attributes> = (ESC) (R) (A)<intXint+Xint+> 

RAOO (Level 0): Unrecognized command, (The terminal is not a 
4112 or a 4113.) 

RA10 (Level 2): Surface does not exist (has not been defined 
with <set-surface-def initions> command) . 

RA11 (Level 2): Invalid surface number. (In the 4112, must 
be in the range from -1 to 3; in the 4113, 
must be in the range from -1 to 4.) 

RA21 (Level 2): Invalid wipe index. (Must be in the range 
from to 65535.) 

RA31 (Level 2): Invalid border index. (Must be in the range 
from to 65535.) 

RB <Set-Background-Gray-Level> = (ESC) (R) (B)<int> 

RB00 (Level 0) : Unrecognized command . (The terminal is not a 
4112 or a 4113.) 

RB11 (Level 2) : Invalid gray level (must be in the range 
from to 100) . 

RC <Select-View> = (ESC) (R)(C)<int> 

RC00 (Level 0) : Unrecognized command . (The terminal is not a 
4112 or a 4113.) 

RC1 1 (Level 2) : Invalid view number . (Must be in the range 
from -1 to 64.) 
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RD <Set-Surface-Definitions> = (ESC) (R ) (D ) <int-array> 

RDOO (Level 0): Unrecognized command. (The terminal is not a 
4112 or 4113.) 

RD10 (Level 2): Occupied undefined surface . (This command 
would have resulted in a dialog area 
viewport, pixel viewport, or numbered graph- 
ic viewport residing on an undefined sur- 
face . ) 

RD11 (Level 2): Invalid <int-array> parameter . 

In the 4112, the array count must be in the 
range from 1 to 3» and the <int>s in the 
array must be in the range from to 3. 

In the 4113, the array count must be in the 
range from 1 to 4, and the <int>s in the 
array must be in the range from to 4. 

RD12 (Level 3 ) • Parameter 3 memory error . (Out of memory 

while trying to parse the <int«-array> param- 
eter.) 



RE <Set-Border-Visibility> = (ESC) (R)(E)<int> 

RE00 (Level 0): Unrecognized command . (The terminal is not a 
4112 or a 4113.) 

RE 11 (Level 2) : Invalid "border mode 11 parameter (must be 0, 
1 , or 2 ) . 

RF <Set-Fixup-Level> = (ESC) (R)(F)<int> 

RF00 (Level 0) : Unrecognized command . (The terminal is not a 
4112 or a 4113.) 



RF1 1 (Level 2): Invalid fixup level (must be in the range 
to 6). 
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RG <Set-Surface-45ray-Level8> = (ESC) (R)(G)<intXint+- 
array> 

RGOO (Level O): Unrecognized command, (The terminal is not a 
4112 or a 4113.) 

RG10 (Level 2): Surface does not exist (has not been defined 
with a <set-surface-def initions> command) . 

RG11 (Level 2): Invalid surface number. (In the 4112, must 
be in the range from 1 to 3. In the 4113, 
must be in the range from 1 to 4. ) 

RG21 (Level 2): Invalid surface-gray-levels array. (The ar- 
ray count must be even; the first <int+> in 
each pair must be a color-index in the range 
from 1 to 65535; the second <int> in each 
pair must be a valid gray-level: a number in 
the range from to 100). 

RG22 (Level 3)« Parameter 2 memory error. (Out of memory 
while parsing the <int-array> parameter.) 

RH <Set~Pixel-Beam-Position> = (ESC) (R) (H)<xy> 

RH00 (Level 0): Unrecognized command. (The terminal is not a 
4112 or a 4113.) 
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RI <Set-Surface-Visibility> = (ESC) (R ) (I )<int-array> 

RI00 (Level 0) : Unrecognized command • (The terminal is not a 

4112 or a 4113.) 

RI10 (Level 2) : A surface number in the <int-array> is for a 
surface which does not exist (that is, a 
surface , which has not been defined with a 
< set-sur face— definition s> command) . 

RI 1 1 (Level 2) : Invalid <int-array> . (The <int-array> con- 
sists of (surface number , visibility) pairs. 
In the 4112, "surface number" <int>s must be 
in the range from 1 to 3; in the 41 13, they 
must be in the range from 1 to 4. In both 
terminals , the "visibility" <int>s must be 
in the range from to 2) . 

RI12 (Level 3 ) * Parameter 1 memory error . (Out of memory 
while parsing the <int-array> parameter . ) 

RJ <Lock-Viewing-Keys> = (ESC) (R)(J)<int> 

RJ00 (Level 0) : Unrecognized command . (The terminal is not a 
4112 or a 4113.) 

RJ11 (Level 2): Invalid locking mode parameter (must be or 

1). 
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RK <Delete-View> = (ESC) (R) (K)<int> 

RKOO (Level 0) : Unrecognized command. (The terminal is not a 
4112 or a 4113.) 

RK10 (Level 2): The designated view does not exist (has not 
been defined with a <select-view> command) . 

RK11 (Level 2) : Invalid view number (must be in the range 

from -1 to 64). 

RL <Runlength-Write> = (ESC) (R) (L)<int+-array> 

RL00 (Level 2) : Unrecognized command. (The terminal is not a 
4112 or 4113.) 

RL11 (Level 2) : Invalid runlength-code array. (The array 

count must be in the range from to 65535, 
and each <int+> in the array must also be in 
the range from to 65535. ) 

RL12 (Level 3) : Parameter 1 memory error . (Out of memory 

while parsing the runlength-code array, or 
while attempting to execute the command . ) 

RN <Set-Surface-Priorities> = (ESC) (R ) (N ) <int-array> 

RN00 (Level 0) : Unrecognized command . (The terminal is not a 

4112 or a 4113.) 

RN10 (Level 2) : Surface does not exist (has not been defined 
with a <set-surface-def initions> command ) . 

RN1 1 (Level 2) : Invalid surface priorities array. (In the 

41 12, each in the array must be in the range 
from 1 to 3. In the 4113, each <int> must be 
in the range from 1 to 4. ) 

RN12 (Level 3) : Parameter 1 memory error . (Out of memory 
while parsing the <int-array> parameter . ) 
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BP <Raster~Write> = (ESC) (R ) (P ) <int><char-array> 

RPOO (Level 0): Unrecognized command. (The terminal is not a 
4112 or 4113.) 

RP11 (Level 2): Invalid number of pixels. (Must be in the 
range from to 65535.) 

RP21 (Level 2): There are too many or too few pixels in the 
<code-array>. 

RP22 (Level 3) : Parameter 2 memory error* (Out of memory 
while parsing the <char-array> parameter . ) 

RQ <Set-View-Display-Cluster> = (ESC) (R)(Q)<int~array> 

RQ00 (Level ) : Unrecognized command ( terminal is not a 4112 

or 4113). 

RQ11 (Level 2) : Invalid <int-array> parameter . (Each view 
number in the <int-array> must be in the 
range from -2 to 64. ) 

RQ13 (Level 3) : Out of memory while parsing the <int-array> 
parameter . 
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RR <Rectangle~Fill> = (ESC) (R ) (R ) <xy><xy><int+> 

RROO (Level 0): Unrecognized command, (The terminal is not a 
4112 or a 4113.) 

RR11 (Level 2): Invalid "lower left" coordinates. (X must be 
in the range from to 639, and Y in the 
range from to 479.) 

RR21 (Level 2): Invalid "upper right" coordinates., (X must 
be in the range from to 639, and Y in the 
range from to 479.) 

RR31 (Level 2): Invalid fill-index (must be in the range 
from to 65535. ) 



RS <Set-Pixel-Viewport> = (ESC) (R)(S)<xyXxy> 

RS00 (Level 0) : Unrecognized command . (The terminal is not a 
4112 or a 4113.) 

RS11 (Level 2) : Invalid "lower left" coordinate. (X must be 
in the range from to 639, and Y in the 
range from to 479. ) 

RS21 (Level 2) : Invalid "upper right" coordinate * (X must be 
in the range from to 639, and Y in the 
range from to 479. ) 
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RU <Begin-Pixel-Operations> = (ESC) (R ) (U ) <int><int><int> 

RUOO (Level 0): Unrecognized command . (The terminal is not a 
4112 or 4113.) 

RU10 (Level 2): Surface does not exist (has not been defined 
with a <set-surface-def initions> command), 

RU 1 1 (Level 2): Invalid surface number. (In the 4112, must 
be in the range from -1 to 3. In the 4113, 
must be in the range from -1 to 4. ) 

RU21 (Level 2) : Invalid ALU mode (must be in the range from 

to 16). 

RU31 (Level 2) : Invalid bits-per-pixel . (In the 4112, must 
be 0, 1, 2, 3, or 6. In the 4113, must be 0, 

1, 2, 3, 4, or 6.) 

RV <Set-Viewport> = (ESC) (R) (V)<xyXxy> 

RV00 (Level 0) : Unrecognized command . (The terminal is not a 
4112 or a 4113.) 

RV01 (Level 2) : Invalid <set-viewport> command . (The 

viewport must not be more than eight times 
larger than the current window. ) 

RV1 1 (Level 2) : Invalid "lower left" corner. (X must be in 

the range from to 4095, and Y in the range 
from to 3071 . ) 

RV21 (Level 2): Invalid "upper right" corner . (X must be in 
the range from to 4095, and Y in the range 
from to 3071.) 

RW <Set-Window> = (ESC) (R ) (W)<xyXxy> 

RW00 (Level 0) : Unrecognized command . (The terminal is not a 

4112 or a 4113.) 

RW0 1 (Level 2 ) : One of the four coord inates is outside 
the range to 4 095 (possible only when 
using the NORMAL key) . 

RW2 1 (Level 2 ) : In v al id upper-right corner calcul ated 
by NORMAL . 
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RX <Pixel-Copy> = (ESC) (R) (X)<intXxy><xyXxy> 

RXOO (Level 0): Unrecognized command™ (The terminal is not a 
4112 or a 4113. 

RX10 (Level 2): The specified destination surface does not 
exist . 

RX11 (Level 2): Invalid destination surface . (In the 4112, 
must be in the range from -1 to 3; in the 
4113, must be in the range from -1 to 4.) 

RX21 (Level 2): Invalid destination-lower-left-corner. (X 
must be in the range from to 639, and Y 
must be in the range from to 479. ) 

RX31 (Level 2) : Invalid first-source-corner . (Same range as 
for the destination-lower-left-corner . ) 

RX41 (Level 2) : Invalid second-source-corner . (Same range as 
for the destination-lower-left-corner and 
the first-source-corner . ) 
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SA <Set-Segment-Class> = 

(ESC)(S)(A)<intXint-array><int-array> 

SA03 (Level 2): Command invalid at this time: the specified 
segment is currently being defined. 

SA10 (Level 2): Segment does not exist. 

SA11 (Level 2): Invalid segment number. (Must be in the 
range from -3 to -1 f or from 1 to 32767.) 

SA21 (Level 2): Invalid "removal" class number array. (Each 
class number must -1 or in the range from 1 
to 64.) 

SA22 (Level 3) : Parameter 2 memory error. (Out of memory 

while parsing the "removal 11 <int-array> par- 
ameter.) 

SA31 (Level 2): Invalid "include" class number array. (Same 
rules as for the "removal" class number 
array. ) 

SA32 (Level 3) : Parameter 3 memory error. (Out of memory 
while parsing the "addition" <int-array> 
parameter . ) 

SB <B6gin-Lower-SegMeitt> - (ESC)(S)(B) 

SBOO (Level ) : Unrecognized command (the terminal firmware 

is version 1 or 2 ) . 

SBOO (Level 2 ) : The indicated segment already exists . 

SB01 (Level 2 ) : Invalid for next lower segment number ( cur- 
rent segment ID is 1 ) . 

SB02 (Level 3 ) : Out of memory while ending or beginning 

segment definition* 

SB03 (Level 2 ) s Context error; command is invalid at this 

time. No segment is currently being defined* 
or a graphtex t charac ter is currently being 
defined . 
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SC <End-Segment> = (ESC)(S)(C) 

SC03 (Level 2): Invalid at this time: no segment is current- 
ly being defined. 

SC02 (Level 3) : Out of memory while performing <end-segment> 
command . 

SD <Set-Segment-Detectability> s (ESC) (S) (D)<intXint> 

SD03 (Level 2) : Command is invalid at this time. (The speci- 
fied segment is currently being defined . ) 

SD10 (Level 2) : Segment does not exist. 

SD1 1 (Level 2) : Invalid segment number (must be in the range 
-3 to -1, or 1 to 32767). 

SD21 (Level 2): Invalid "detectability mode" (must be or 1 ) . 

SE <B»gin-l*v-SegB6!it> » (ESC ) (S ) (B ) <int> 

SEOO (Level ) : Unrecogni zed command (the terminal firmware 

is version 1 or 2 ) . 

SE02 (Level 3 ) : Not enough memory to begin segment , or out 

of memory while defining segment . 

SE03 (Level 2 ) : Command is invalid at this time ( a graphtex t 

charac ter or a panel is currently being 
defined ) • 

SE 1 (Level 2 ) : Segment already exists . 

SE1 1 (Level 2 ) : Invalid segment number ( 1 through 32767 are 

valid ) . 
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SG <Set-Graphtext-Font-Grid> = 
(ESC)(S)(G)<intXintXint> 

SG02 (Level 3): Out of memory while defining font grid. 
SG10 (Level 2): Font already exists. 

SG1 1 (Level 2): Invalid font number (must be in the range 
from to 32767 ). 

SG21 (Level 2) : Invalid grid width. (Must be in the range 
from 1 to 4095.) 

SG31 (Level 2): Invalid grid height. (Must be in the range 

from 1 to 4095 J 

SH <Set-Segment-Highlighting> = (ESC) (S) (H)<intXint> 

SH03 (Level 2) : Command is invalid at this time. (The speci- 
fied segment is currently being defined . ) 

SH10 (Level 2) : Segment does not exist . 

SH1 1 (Level 2) : Invalid segment number (must be in the range 
from -3 to -1 , or from 1 to 32767) • 

SH21 (Level 2) : Invalid highlighting mode (must be or 1 ) . 
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SI <Set~Segment-Xmage-Tran5form> 

= (ESC)(S)(I)<int><real><real><realXxy> 

SI03 (Level 2): Command is invalid at this time. (The speci- 
fied segment is currently being defined.) 

SI02 (Level 3): Out of memory while transforming segment. 

SI 10 (Level 2): Segment does not exist. 

31 1 1 (Level 2): Invalid segment number (must be in the range 
-3 to -1, or 1 to 32767). 

SI21 (Level 2) : Invalid X-scaling factor. (Must be in the 
range from -32767.0 to 4-32767.0) 

SI31 (Level 2): Invalid Y-scaling factor. (Must be in the 
range from -32767.0 to +32767.0) 

SI41 (Level 2) : Invalid rotation angle. (Must be in the 
range from -32767.0 to +32767.0) 

SK <Delete-Segment> = (ESC) (S)(K)<int> 

SK02 (Level 3) : Out of memory while attempting to delete a 
segment . 

SK10 (Level 1): Segment does not exist. 

SK1 1 (Level 2) : Invalid segment number (must be -3, -1 , or 
in the range from 1 to 32767) . 

SL <Set-Current-Matching-Class> = 

(ESC)(S)(L)<int-array><int-array> 

SL11 (Level 2) : Invalid "include" segment-class array. 

(Class numbers must be -1 , or in the range 
from 1 to 64. ) 

SL12 (Level 3) : Parameter 1 memory error. (Out of memory 
while parsing the "include" segment-class 

array.) 

SL21 (Level 2): Invalid "exclude" segment-class array. 

(Class numbers must be -1 f or in the range 
from 1 to 64. ) 

SL22 (Level 3): Parameter 2 memory error. (Out of memory 
while parsing the "exclude" segment-class 
array. ) 
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SM <Set-Segment-Writing-Mode> = (ESC) (S)(M)<intXint> 

SM03 (Level 2): Command is invalid at this time, (The speci- 
fied segment is currently being defined, 

SM10 (Level 2): Segment does not exist. 

SM11 (Level 2): Invalid segment number (must be in the range 
from -3 to +32767). 

SM21 (Level 2) : Invalid writing mode (must be or 1), 
SI <BftgiB-Hieli*r-S*gB*nt> ■ (ESC)(S)(i) 

SNOO (Level ) : Unrecognized command ( the terminal firmware 

is version 1 or 2 ) . 

SNOO (Level 2 ) : The ind ica ted segment already exists . 

SN01 (Level 2 ) : Invalid for next higher segment number ( cur- 
rent segment ID is 32767) . 

SN02 (Level 3 ) : Out of memory while ending or beginning 

segment ' definition. 

SN03 (Level 2 ) : Context error ; command is invalid at this 

t ime . No segment is currently being defined , 
or a grapht ex t charac ter is currently being 
defined . 

SO <Begin-Segment> = (ESC) (S) (0)<int> 

5002 (Level 3) : Out of memory while defining segment . 

5003 (Level 2) : Command is invalid at this time. (Another 

segment f a graphtext character, or a panel 
is currently being defined . ) 

50 10 (Level 2) : Segment already exists. 

501 1 (Level 2) : Invalid segment number (must be in the range 

from 1 to 32767). 
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SP <Set-Pivot-Point> = (ESC) (S) (P)<xy> 

No errors are detected for this command, 

SQ <Report-Segment-Status> = (ESC) (S) (Q)<intXchar-ar- 
ray> 

SQ10 (Level 2): Segment does not exist . 

SQ11 (Level 2): Invalid segment number (must be in the range 
-3 to +32767)- 

SQ21 (Level 2) : Invalid array of codes, (Must include only 
the uppercase letters A, D, H, I, M, P, S, 
V, and X. Al so, the array count must be in 
the range from to 32767. ) 

SQ22 (Level 3) : Parameter 2 memory error . (Out of memory 
while parsing the array-of-codes 

<char»»array> . ) 

SR <Rename-Segment> = (ESC) (S) (R)<intXint> 

SR02 (Level 3 ) : Out of memory while renaming a segment (4114 < f 

only) * 

SR03 (Level 2) : Command is invalid at this time. (The speci- 
fied segment is currently being defined . ) 

SR10 (Level 2): Segment does not exist . 

SR1 1 (Level 2) : Invalid segment number (must be in the range 
from 1 to 32767). 

SR20 (Level 2) : A segment with that segment number already 
exists. 

SR21 (Level 2) : Invalid segment number (must be in the range 
from 1 to 32767). 
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SS <Set-Segment-Displ ay-Priori ty> = 
(ESC)(S)(S)<intXint> 

SS03 (Level 2): Command is invalid at this time. (The speci- 
fied segment is currently being defined . ) 

5510 (Level 2): Segment does not exist . 

5511 (Level 2): Invalid segment number (must be in the range 

from -3 to -1 , or from 1 to 32767). 

SS21 (Level 2): Invalid priority number (must be in range - 
32768 to +32767). 

ST <Begin-Graphtext-Character> = (ESC) (S) (T)<intXint> 

ST02 (Level 3) i Out of memory while defining graphtext char- 
acter . 

ST03 (Level 2) : Command is invalid at this time. (A segment f 
panel, or graphtext character is currently 
being defined . ) 

ST1 1 (Level 2) : Invalid font number (must be in the range 
from to 32767). 

ST20 (Level 2): That character already exists in this font. 

ST21 (Level 2): Invalid character number (must be in the 
range from 32 to 126) . 
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SU <End-Graphtext-Character> = (ESC)(S)(U) 

SU03 (Level 1): This command is invalid at this time, (No 
graphtext character is being defined.) 



SV <Set-Segment-Visibility> = (ESC) (S) (V)<intXint> 

SV02 (Level 3) : Out of memory. 

SV03 (Level 2) : Command is invalid at this time. (The speci- 
fied segment is currently being defined . ) 

SV10 (Level 2) : Segment does not exist. 

SV1 1 (Level 2) : Invalid segment number (must be in the range 
from -3 to +32767). 

SV21 (Level 2) : Invalid visibility mode (must be or 1). 

SX <Set-Segment-Position> = (ESC) (S) (X)<intXxy> 

SX02 (Level 3): Out of memory. 

SX03 (Level 2) : Command is invalid at this time : the 
specified segment is currently being 
defined . 

SX10 (Level 2): Segment does not exist. 

SX1 1 (Level 2) : Invalid segment number (must be in the range 

from -3 to +32767.) 
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SZ <Delete-Graphtext-Character> = (ESC) (S) (Z)<intXint> 

SZ03 (Level 2) : Command is invalid at this time. (A graph- 
text character is currently being defined . ) 

SZ 10 (Level 1): The specified font does not exist (no char- 
acters have been defined for that font) . 

SZ 1 1 (Level 2): Invalid font number (must be in the range 
from -1 to 32767 ). 

SZ20 (Level 1 ) : The character specified does not exist in 
this font . 

SZ21 (Level 2) : invalid character number . (Must be -1, or in 
the range from 32 to 126. ) 



TB <Set-Background-Color> = (ESC) (T) (B) <int><int><int> 

TBOO (Level ) : Unrecognized command ( terminal is not a 4112 

or 4113). 

TB1 1 (Level 2) : Invalid first parameter. (If in HLS mode , 

must be in the range from -32768 to +32767. 
If in RGB or CMY mode, must be in the range 
from to 100. ) 

TB21 (Level 2) : Invalid second parameter (must be in the 
range from to 100) . 

TB31 (Level 2): Invalid third parameter (must be in the 
range from to 100). 
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TG 



<set-Surface-Color-Map> = (ESC) (T ) (G ) <int><int-array> 



TGOO (Level 0)i Unrecognized command* (terminal is not a 4112 

or 41 1 3) * 

TG10 (Level 2): Surface does not exist (has not been defined 
with a <set-surface-def initions> command), 

TG1 1 (Level 2): Invalid surface number . (Must -1 , or in the 
range from 1 to 4) . 

TG21 (Level 2): Invalid color-mixtures array. (The array 



count must be a multiple of four. The first 
<int> in each group of four <int>s must be 
or a color-index in the range from 1 to 
32767. The other three <int>s must be valid 
HLS, RGB, or CMY values, according to the 
most recent <set-color-mode> command . If the 
HLS system is in effect, the "hue" parameter 
must be in the range from -32768 to +32767, 
while the "lightness" and "saturation" par- 
ameters must be in the range from to 100. 
If the RGB or CMY system is in effect, then 
all three color mixture parameters must be 
in the range from to 100. ) 



TG22 (Level 3)* Parameter 2 memory error . (Out of memory 
while parsing the color-mixtures array.) 

TM <Set-Coior-Mode> = (ESC) (T) (M)<intXintXint> 

TMOO (Level 0) : Unrecognized command (terminal is not a 4112 

or 41 1 3 ) • 

TM1 1 (Level 2) : Invalid color-specif ying-mode (must be in 
the range from to 3). 

TM21 (Level 2) : Invalid color-overlay-mode (must be in the 
range from to 3). 

TM31 (Level 2) : Invalid gray-mode (must be 0, 1, or 2) . 
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Appendix D 
BIT PLANES AND SURFACES 



INTRODUCTION 

For a number of advanced appl icat ions , several 4112 and 4113 
commands let you specify "surface minus one," This is a 
"super surface" consisting of all bit planes of all surfaces 
currently defined. 

To use the super surface properly, you should understand in 
detail the relationship between the terminal's bit pi anes 
and its writing sur faces . The bit planes are part of the 
terminal's hardware circuitry, while the writing surfaces 
are artificial constructs accomplished by the terminal's 
firmware programming . 

This appendix explains these concepts. Topics included are: 
o The terminal's bit planes. 

o How the bit planes are grouped to form writing 
sur f aces . 

o A definition of the super sur face . 
o How the super sur face might be used . 



BIT PLANES 

In the standard 4113 terminal , and in a 4112 equipped with 
Option 20 , the terminal ' s raster memory is organi zed into 
three bit pi anes . (If a 4112 does not have Option 20 , it has 
only one bit pi ane . If a 4113 is equipped with Option 2 1 , it 
has four bit pi anes . ) For each pix el location on the screen , 
there is a one-bit memory cell in each of the bit pi anes . 
Figure D-1 shows this . 
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BIT PLANES AND SURFACES 



Refer now to Figure D-2 (for the 4112) or Figure D-3 (for 
the 4113). To display information on the screen , circuitry 
in the terminal scans all bit planes simultaneously. For 
each pixel on the screen, the circuitry reads one binary bit 
from each bit plane. All the bits for each pixel location 
form a binary word . In the 4112, this word consists of one 
or three bits , depend ing on whether Option 20 is installed . 
In the 4113, the word has three or four bits , accord ing to 
whether Option 2 1 is installed . 

The circuitry takes each such pixel word and uses it as an 
index into a table ( an address for a fast-access semiconduc- 
tor memory) . In the 4112, this table is the Video Map memory 
on the 4112 Raster Memory board . In the 4113, this table is 
the Color Map memory on the 4113 Color Map board . 

In the 4112 (Figure D-2) , the data read from the Video Map 
table goes to a DAC (Dig ital- to-Analog Converter) , which 
converts it to an analog voltage to determine the brightness 
of the display . 

In the 4113 (Figure D-3), there are three DACs , one for each 
of the additive pr imary colors . Their outputs determine the 
brightnesses of the red , green , and blue phosphors for each 
pixel of the displ ay . 
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Figure D-2. 4112 Hardware Display Circuitry, 
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Figure D-3. 4113 Hardware Display Circuitry. 
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SURFACES 

The "multiple writing sur faces" concept is used in many 
commands, including the following: 

<set-surf ace- definition s> 
<set-surface-priorities> 
< set- sur f ace- visibil ity> 
<set- sur face- gray-levels> 
< set- sur f ace-color-map> 
<set-view-attributes> 
<begin-pixel-operations> 
<pixel-copy> 

In all these commands , the terminal f s firmware program 
emul ates the mul tipl e wr iting sur faces by the way it wr ites 
into the 4112 Video Map memory or the 4113 Color Map memory . 



An Example (4112 Terminal) 



Consider , for example , a 4112 terminal which is equipped 
with three bit pi anes (Option 20 ) . Figure D-4 shows the 
resul t of sending the following command to such a terminal : 

<set- sur face-definitions: ( 1 , 2)> 

This command groups the terminal 1 s three bit pi anes into two 
"writing sur faces . " Surface 1 has a single bit plane, while 
Surface 2 has two bit pi anes . Sur face 1 is d eemed to be in 
front of Sur face 2 , as shown in Figure D-4 . 

To create an image on the display , the terminal scans the 
bit pi anes , obtaining from them a three-bit binary word for 
each pixel of the display . The most- significant bit of this 
word is a color-index ( or "gray-index" ) for Sur face 1 . The 
least- significant two bits form the index for the same pixel 
location on Sur face 2 . 

In the 4112, index zero means "transparent . " Al 1 non-zero 
ind ices are opaque . Thus , when a pixel's Sur f ace 1 index is 
zero , that pixel 1 s brightness is determined by the pixel's 
index for the sur f ace behind it--Sur f ace 2 in this example . 
But when a pixel ? s Sur f ace 1 index is non-zero , the pixel 1 s 
brightness depends only on that non-zero index ; the index 
for Sur f ace 2 is irrelevant , s ince Sur f ace 2 is behind 
Sur face 1 . ( Any images on Sur face 2 are obscured by images 
on Sur face 1 . ) 
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Figure D-4. Emulating Two Writing Surfaces in the 41 12 Terminal . 
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An Example (4113 Terminal) 



Figure D-5 shows a corresponding example for a 4113 terminal 
equipped with four bit planes (Option 21). The illustration 
shows the result of the following commands: 

<set- background-gray-lev el: 0> 
<set-color-mo'de: 0, 1, 1> 
<set-sur face-definitions : (2 , 2)> 

Here , the <set-color-mode> command's second parameter is 1. 
This specifies "OPAQUE .mode * " in which images on the front 
surface obscure images drawn on surfaces behind. The <set- 
sur f ace-def initions> command allocates the terminal's four 
bit planes among two writing surfaces. Sur face 1 has two bit 
planes* and so dae$ Surface 2. 



D-8 



4110 SERIES COMMAND REFERENCE 



BIT PLANES AND SURFACES 



5 



III 

SB i I 



11 



m a 



m o 

o D 



ii 



*r - m 



mmmm *~ 



mm® s^® « 



i 



o o 
< 
o 



■ 

4' 



ill ii 

if Pi 

it! ill 



illll II! 




Figure D-5. Emulating Two Writing Surfaces in the 4113 Terminal 
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Thus, the most-significant two bits for each pixel word 
comprise a color-index for Surface 1, while the least- 
significant two bits comprise a color- index for Sur f ace 2 . 
That is, the Color Map memory's most-significant address 
bits represent a Sur face 1 color index , while its 1 east- 
signf icant two address bits represent a Sur face 2 color- 
index . 

In Figure D-5 , the Color Map memory is shown with the 
default color mixtures , as set by the <se t- surf ace- defini- 
tions> command : 

Index : Transparent ( look through to the sur face 
behind ) 

Index 1: White ( full brightness on all three DACs) 
Index 2 : Red 
Index 3* Green 

Since OPAQUE mode is in effect , any non-zero index on 
Sur face 1 obscures any index behind it on Sur f ace 2, For 
instance , whenever a pixel 1 s Surface 1 index is 1 ( binary 
01 ) , the pix el is d ispl ayed in the "white" color mixture , 
regardless of the Sur face 2 color- index for that pixel . (The 
red , green , and blue brightnesses are at their max imums . ) 

Likewise, when the Surface 1 index is 2 ( binary 10), the 
pixel is red ; the red brightness is at its max imum , wh ile 
the green and blue brightnesses are zero . Again , when the 
Sur face 1 color- index is 3 ( binary 11), the pixel is blue ; 
only the blue DAC is turned on . 

If the Surface 1 index is zero ( transparent) , then we look 
through Surface 1 to see what may be drawn on Sur face 2 . For 
instance , when the Sur f ace 1 color- index is zero and the 
Sur face 2 color- index is 1 , the pix el is wh i t e . Again , when 
the Sur f ace 1 index is zero and the Sur face 2 index is 2 , 
the pixel is red . 

When both color-indices are zero , we see the background 
color . (This situation is represented by the first entry in 
the Color Map table . ) 
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Manipulating Surfaces 



The commands which manipulate surfaces do so by rearranging 
the data in the 4112 Video Map memory or the 4113 Color Map 
memory. Thus, all of the following commands affect the data 
in the Video Map or Color Map memory: 

<set-sur f ace-def ini tions> 
<set-sur f ace- prior it ies> 
<set-sur face- visib il it y> 
<set-sur f ace- gray- lev el s> 
<set-sur f ace-color-map> 
< set- co lor- mod e> 

For instance , a < se t- surf ace- prior it ies> command can pi ace 
Surface 2 "in front of" Surface 1. Figure D-6 shows the 
result of such a command on a 4113 terminal. With Surface 2 
deemed to be in front of Surface 1, the Surface 2 index 
takes priority over the Surface 1 index. Thus, compared to 
Figure D-5 , the Color Map table in Figure D-6 is rearranged. 
For instance, whenever a pixel's Surface 2 index is 1, that 
pixel is displayed as white, regardless of the Surface 1 
index . 
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Figure D-6. Effect of Changing the Surface Priorities. 
D-12 rev, mar 1982 M 1,1 SERIES COMMAND REFERENCE 



BIT PLANES AND SURFACES 



THE SUPER SURFACE 

A few of the terminal's commands let you specify "surface 
minus one . f! This is a "super surface , " consisting of all bit 
planes in all surfaces currently defined . Figure D-7 shows 
the concept . 

In a color-index for a pixel of the super surface , the most- 
significant bit is the same as the most-significant bit in 
that pixel's Surface 1 color-index . The least- significant 
bit in the super-surface index is the same as the least- 
significant bit in the color-index for the highest- numbered 
sur face . 

Let us suppose , as in Figure D-7 , that there are two 
sur faces of two bit pi anes each. Then if a pixel's "super- 
sur face color-index" is 9 (binary 1001), that means that the 
pixel 1 s Surface 1 index is 2 (binary 10 ) and its Surface 2 
index is 1 ( binary 01 ) . 
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USING THE SUPER SURFACE 

The following examples show how the super surface might be 
used . 



Saving The Screen Display On a Disk File 



Suppose that the terminal has three bit planes. (That is, 
the terminal is a standard 4113? or a 4112 equipped with 
Option 20.) In that case, the following commands save the 
entire contents of the screen on a disk file. The contents 
of all viewports, on all writing surfaces are saved; this 
includes the dialog viewport, if the dialog area is visible. 

< beg in- pixel- operations : -1, 11, 3> 
<set-pixel- viewport: (0,0), (639, 479)> 
<save: "RUN", -1, "TO", "F0:SCREEN"> 

Here , the < beg in- pixel- operation s> command specifies the 
" super surface" as the sur face on which the pixel viewport 
is located . Al so specified are ALU mode 1 1 ( "set mode" ) , and 
three bits per pixel . 

The < set- pixel- vie wport> command sets the pixel viewport to 
occupy all of raster memory space . This is the default value 
for the pix el viewport , so this command need not be issued 
if the pixel viewport has not been changed since power-up . 

The <save> command specifies that the entire contents of the 
pixel viewport ( "- 1 " pixels) are to be saved using <run- 
leng th-wr ite> commands ( the "RUN" keyword ) on the file named 
SCREEN on disk drive number zero . 

To restore the image from the file F0 : SCREEN , you < load> the 
file back into the terminal. When doing so, however, be sure 
that the terminal is set as it was when the file was created 
with the <save> command . That is , the terminal should have 
the same number of sur faces as when the file was created , 
with the same number of bit planes for each surface. Al so , 
the background color , and the color mixtures for each 
surface's color-indices, should be the same as when the file 
was created . 

Under those circumstances , the image on the screen can be 
restored with a <load> command : 

<load: "F0:SCREEN"> 



4110 SERIES COMMAND REFERENCE 



D-15 



BIT PLANES AND SURFACES 

Changing the Effect of Overlapping Colors (4113 Only) 



In the 4113 terminal, the <set- sur face- col or -mod e> command 
lets you specify three different "overlay modes," or ways of 
representing parts of the screen where images on one surface 
overlay images on another surface* In OPAQUE mode, images on 
" front" surfaces obscure images on surfaces behind . (This is 
the default in the 4113? and the only overlay mode available 
in the 4112.) Two other modes are provided in the 4113 
(SUBTRACTIVE and ADDITIVE modes) . 

However, suppose none of these modes satisfy you. For 
instance, suppose you have been using the terminal to 
emulate multiple overlays on a light table. There are two 
surfaces, of two bit planes each, and the overlay mode 
(<set-color~mode> command) is SUBTRACTIVE. The color- 
mixtures are set follows: 

Surface Color-Index Color-Mixture HLS Coordinates 







H 


L 


S 


1 


Transparent 








1 


Red 


120 


50 


100 


2 


Green 


240 


50 


100 


3 


Dark Blue 





50 


100 


2 


Transparent 








1 


Red 


120 


50 


100 


2 


Green 


240 


50 


100 


3 


Blue 





50 


100 


Background 


White 





100 






If you try this, you will find that whenever a red region on 
one surface overlays. a green region on the other surface, 
the pixels in the region of overlap are black. This is also 
the case whenever red overlays blue, or blue overlays green. 

With the < set- sur face- col or- map> command, you can specify a 
particular color mixture for each combination of colors on 
the two surfaces. That is, you set the terminal's Color Map 
table exactly as you wish, for all overlay possibilities. 
That way, you can specify one color mixture when red 
overlays green, another when green overlays red, and yet 
another when red overlays blue. 
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To do this, you first decide exactly what color mixture you 
want for every overlay combination and prepare a table 
accordingly. Then, you issue a <set-sur face- color- map> com- 
mand for "surface minus one," setting the Color Map memory 
to match your table,, 

Suppose, for instance, that your table is like Table D-1 . 

Table D-1 



A SET OF COLOR OVERLAY COMBINATIONS 



Combination 
of Overlay 

LOJLOr 


Color-Indices 


Super Surface 
Color Mixture 

H L S 


Surface 

On a 


Surface 

Tun 


Super 


db CKg r oun a 




(00) 




( 00 ) 




( nnnn ) 

\ U U U U J 


wnite 

100 


Red on 
sur face 2 




(00 ) 


1 


1 

f 000 1 ) 


Light Red 
120 67 100 


ur een on 
sur f ace 2 




(00) 


2 

(10) 


2 

(0010) 


l i g n u ur een 
240 67 100 


Blue on 
sur face 2 




(00) 


3 

(11) 


3 

(001 1 ) 


Light Blue 
67 100 


Red on 
sur f ace 1 


1 

(01) 




(00) 


4 

(0100) 


Light Red 
120 67 100 


Red over red 


1 

(01 ) 


1 

(01 ) 


5 

(0101 ) 


Dark Red 

120 33 100 


Red over 
green 


1 

(01 ) 


2 

(10) 


6 

(0110) 


Dark Gray 
33 


Red over 
blue 


1 

(01) 


3 

(11) 


7 

(0111) 


Darker Gray 
15 


Green on 
sur face 1 


2 

(10) 




(00) 


8 

(1000) 


Light Green 
240 67 100 
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Table D-1 (cont) 



A SET OF COLOR OVERLAY COMBINATIONS 



of Overlay 
Colors 


Color-Indices 


ouper ouridce 
Color Mixture 

U T Q 

n Li o 


Surface 
One 


Surface 
Two 


Super 
Surface 


Green over 

r\ /~\ 


2 

(10) 


1 

(01) 


9 

(1001 ) 


Dark Gray 


Green over 

a V A & Y) 

i ecu 


2 

(10) 


2 

(10) 


10 

(1010) 


Dark Green 

PUD 3 3 100 


Green over 
b 1 ue 


2 

(10) 


3 

(11) 


11 

(1011) 


Darker Gray 
u Id u 


Blue on 
sur f ace 1 


3 

(11) 




(00) 


12 

(1 100) 


Light Blue 
67 100 


Blue over 
red 


3 

(11) 


1 

(01) 


13 

(1101) 


Darker Gray 
15 


Blue over 
green 


3 

(11) 


2 

(10) 


14 

(1110) 


Darker Gray 
15 


Blue over 
blue 


3 

(11) 


3 

(11) 


15 

(1111) 


Dark Blue 

33 100 
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To achieve these color overlay combinations, you would 
define the super- sur f ace color mixtures as in Table D-2 

Table D-2 

SOME SUPER-SURFACE COLOR MIXTURES 



Color-Index 



Color Mixture 





H 


L 


S 








100 





1 


120 


67 


100 


2 


240 


67 


100 


3 





67 


100 


4 


120 


67 


100 


5 


120 


33 


100 


6 





33 


100 


7 





15 


100 


8 


240 


67 


100 


9 





33 





10 


240 


33 


100 


11 





15 





12 





67 


100 


13 





15 





14 





15 





15 





33 


100 



Once having completed the table, you can compose a <set- 
sur f ace-color-map> command to load the Color Map memory in 
accordance with your table . (In this command , ,f index 0" can 
be used to specif y the background color . ) 
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<set-sur face-color-map : -1, color-mix tures-array > 

= (ESC) (T)(G) 
<int: -1 > 
<int: 64> 

<int: OXint: OXint: OXint: 0> 
<int: IXint: 120Xint: 67><int: 100> 
<int: 2Xint: 240Xint: 67><int: 100> 
<int: 3><in.t: OXint: 67Xint: 100> 
<int: 4Xint: 120><int : 67><int: 100> 
<int: 5><int: 120Xint: 33><int: 100> 
<int: 6><int: OXint: 33><int: 100> 
<int: 7><int: OXint: 15><int: 100> 
<int: 8><int: 240><int: 67><int: 100> 
<int: 9><int : OXint: 33><int: 0> 
<int: 10><int: 240Xint: 33><int: 100> 
<int: 11Xint: OXint: 15><int: 0> 
<int: 12><int: OXint: 67><int: 100> 
<int: 13Xint: OXint: 15><int: 0> 
<int: 14Xint: OXint: 15><int: 0> 
<int: 15><int: OXint: 33><int : 100> 
= (ESC) (T)(G)( !) 

(D)(0) (0)(0)(0)(0)(0)(1 ) (G)(8) (D)(3)(F) (4) 
(2 )(0)(0) (D)(3)(F) (4)(3)(0)(O)(0)(F)(4) 
(4) (G)(8) (D)(3) (F)(4) (5) (G)(8)(B) (1 )(F) (4) 
(6)(0)(B) (1 )(F) (4)(7)(0)(?) (F) (4) 
(8 HOMO) (D)(3)(F) (4)(9)(0)(B) (1 )(0) 
(:)(0)(0)(B)(1)(F)(4)(;)(0)(?)(0) 
(<)(0)((D)(3)(F)(4)(=)(0)(?)(0) 
(>)(0)(?)(0)(?)(0)(B)(1)(F)(4) . 



Special Considerations 



Setting color mixtures on the super surface affects only the 
terminal's Color Map memory. It does not affect other 
portions of the terminal's memory, such as tables recording 
the color mixtures for each surface. This results in the 
following limitations of the super surface: 



o The < report- term inal-settings> command cannot be 
used to learn the color mixtures on the super 
surface. (You can learn the color mixtures on the 
background, and surfaces 1, 2, etc., but not the 
super-surface colors.) This is because the terminal 
does not "remember" the color mixtures on the super 
surface (except in the Color Map memory, which is 
part of the display hardware and not part of the 
terminal's main memory). 
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o Any command which writes to the color map memory 

will wipe out the effect of an earlier <set-sur f ace- 
color-map> command for the super surface. Therefore, 
after defining color mixtures for the super sur f ace , 
you should avoid issuing any of these commands: 

<set~ surface- definition s> 
<set-surface-priorities> 
<set-sur face- visib il it y> 
<set-sur face- gray- lev el s> 

< set- sur f ace-color-map> 

<set-color-mode> 

< set- background- gr a y- lev el > 

<set-background-color> 
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Appendix E 
COLOR COORDINATES 



At any one time , the 4113 can display only a limited number 
of d if f erent color mixtures . However , you can select wh ich 
color mixtures are in use from a universe of 4096 possible 
color mixtures . To do this , you use the <set-background- 
color> and < set- surface- color-map > commands , which are de- 
scribed in Section 4 . 

In these commands , you specify a par ticul ar color mixture 
using one of three color coordinate systems : RGB (Red, 
Green, Blue), CMY (Cyan, Magenta, Yellow), and HLS (Hue, 
Lightness , Saturation ) . This append ix describes those color 
coord inate systems . 

<Set-Color-Mode> Command 



On power-up , the 4115 is set to use the HLS system . You can 
select other coord inate systems with the < set- col or- mod e> 
command . (The SETUP mode name for this command is CMODE . ) 

< set- color-mod e> 

= (ESC) (T)(M) 

<int : color- spec if ying-mode> 
< int : c o lor - ov er lay-mod e> 
< int : gr ay-mode > . 

The first parameter , color- specif ying-mode , is 1 to select 
the RGB color coord inate system , 2 to select the CMY system 
or 3 to select the HLS system . If this parameter is zero , 
the color- spec if ying-mode is left unchanged . 

( For information about the other two parameters , see the 
description in Section 4 of the < set-color-mode> command . ) 

In SETUP mode, the operator types the keywords "RGB," "CMY, 
and "HLS" instead of the numbers "1," "2," and "3." Consid- 
er, for instance , the following examples : 

CMODE RGB Selects the RGB color coordinate system 

CMODE CMY Selects the CMY color coordinate system 
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CMODE HLS Selects the HLS color coordinate system, 

CMODE OPAQUE Leaves the color coordinate system 

unchanged, but sets the overlay mode to 
OPAQUE. 

RGB Coordinate System 



In the RGB color coordinate system , you specify a color 
mixture as percentages of red, green, and blue, in that 
order. Each color coordinate is an integer in the range from 
to 100. 

For instance, one way to set the background color to red is 
to issue these commands: 

<set-color-mode : 1, 0, 1 > Select the RGB color 

coordinate system . 
Leave the overlay 
mode unchanged, but 
set the gray mode to 
"COL" to ensure that 
the display is in 
color rather than in 
black and white. 



<set-background-color : 100, 0, 0> 



Set the intensities 
of the red, green, 
and blue electron 
beams to 100%, 0%, 
and 0% of their max- 
imum values, respec- 
tively . 



Likewise, you can set color-index one on surface number 
three to "green," as follows: 

<set-color-mode : 1 , , 1 > Select RGB color 

coordinates . 



<set-sur f ace-color-map : 1 , ( 1 , 0, 100 , 0)> Set the color mix- 
ture for sur face 
one , color-index 
one , as follows : 0% 
red , 100% green , 0% 
blue . 
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In SETUP mode, these latter two commands are typed as 
follows: 

CMODE RGB 

CMAP 1 1,0, 100, 

From the host computer , these same commands are sent as 
escape sequences: 

<set-color-mode : 1,0, 1 > 

= (ESC) (T) (MXint: 1><int: OXint: 1> 

= (ESC) (T)(M) (1 )(0)(1 ) . 

<set- surface- color-map: 1, (1,0, 100, 0)> 

= (ESC) (T)(G) 
<int: 1> 

<int-array: ( 1 , 0, 100, 0)> 

= (ESC) (T)(G) 
<int: 1> 

<int: 4><int: 1><int: OXint: 100><int: 0> 
= (ESC)(T)(G)(1)(i|)(1)(0)(F)(4)(0) . 



CMY Coordinate System 



In the CMY system, the three color coordinates are percent- 
ages of cyan, magenta, and yellow pigments. Each coordinate 
is an integer in the range from to 100. 

(The additive primaries -- red, green, and blue -- are used 
when mixing lights to produce color mixtures. The subtrac- 
tive primaries -- cyan, magenta, and yellow — are used when 
mixing pigments.) 

The CMY coordinates are related to the RGB coordinates as 
follows : 

C = 100 - R 
M = 100 - G 
Y = 100 - B 
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For instance , you can use the following commands to select a 
red background color : 

<set-color-mode : 2, 0, 1 > Select the CMY coor- 

dinate system , while 
leav ing the overlay 
mode unchanged and 
setting the gray 
mode to ,f color" 
rather than ?! black 
and white . 11 

< se t- ba ckg round -col or : , 100 , 100> Mix pigments of 0% 

cyan , 100% magenta , 
and 100% yellow to 
produce a "red" co- 
lor mixture . 

In SETUP mode , the operator can type these command s as 
follows : 

CMODE CMY 
<ESC>TB 0, 100, 100 

(There is no SETUP mode name for the < set- ba ckg round- col or > 
command , so in SETUP mode the operator must use the esc ape- 
sequence op code for that command . ) 

The same two command s c an be sent from the host computer as 
escape sequences : 

<set-color-mode : 2 , , 0> 

= (ESC) (TMMXint: 2><int: OXint: 0> 
= (ESC) (T)(M) (2)(0)(0) 

< set- background- color : 0, 100 , 100> 

= (ESC) (T) (BXint : OXint: 100><int: 100> 

= (ESC) (T)(B) (0)(F) (4)(F) (4) 
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COLOR COORDINATES 



HLS Coordinate System 



In the HLS coordinate system , the universe of possible color 
mixtures is represented as a double-ended cone ( Figure E-1 ) . 
The three coord inates are H (hue) , L ( lightness ) , and S 
( saturation ) . 

Hue • The hue coordinate runs around the cone , from to 360 
degrees : 



Lightness . The lightness coordinate runs up the cone , from 
black at the bottom (0% lightness) to white at the top (100% 
lightness) . 

Saturation . The saturation coordinate expresses the degree 
to which a color mixture differs from a shade of gray . This 
coord inate runs rad ially outward from the axis of the HLS 
cone . It is expressed as a percentage of the maximum 
saturation that is possible at a given lightness level . The 
most f ully saturated color mixtures are at the 50% lightness 
level , where the double-ended cone is widest . 

The HLS coord inate system is easier to use than the RGB or 

CMY systems ; for this reason , it is the default color 

coord inate system and is in effect when the terminal is 
turned on . 

In the HLS coord inate system , all "red 11 color mixtures have 
the same hue angle . For instance , "dark red," " f ully satu- 
rated red , " and "light red" differ only in the 1 ightness 
coord inate : 



Color Name 


H 


L 


S 


Dark Red 


120 


33 


100 


Fully Saturated Red 


120 


50 


100 


Light Red 


120 


67 


1 00 
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Hue Coordinate 



Color Name 



60 

120 

150 

180 

240 

300 



Blue 

Magenta 

Red 

Orange ( red-yellow) 

Yellow 

Green 

Cyan 



COLOR COORDINATES 



Likewise , you can get light-colored mixtures of different 
hues by setting the lightness coordinate to a relatively 
large value and varying only the hue coordinate: 



Color 


Name 


H 


L 


S 


Light 


Red 


120 


67 


100 


Light 


Orange 


150 


67 


100 


Light 


Yellow 


180 


67 


100 


Light 


Green 


240 


67 


100 


Light 


Blue 





67 


100 



Again, different mixtures of a given color with gray can be 
achieved by varying only the saturation coordinate: 



Color Name 


H 


L 


S 


50% Gray 


120 


50 





Grayish Red 


1 20 


50 


50 


Fully Saturated Red 


120 


50 


100 



For instance , to set the color-index 2 on Surface 1 to a 
light shade of green , you could issue these commands: 

<set-color-mode : 3*0, 1 > . Select the HLS co- 

lor coordinate 
system , while 
leaving the over- 
lay mode unchanged 
and setting the 
gray mode so that 
the display is in 
color rather than 
in black and 
white . 

< set- surface- col or -map : 1,(2, 240 , 67 , 100 )> Set the color mix- 
ture for Sur face 
.1 , color-index 
two , as follows : a 
green hue (H=240), 
of a light shade 
(L=67) , with the 
max imum saturation 
possible at that 
lightness level 
(S=100) . 

For more information on the < set- color-mod e> and <set- 
sur f ace-color-map> commands , see the descriptions in 
Section 4 . 
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In the HLS color coordinate system 
the color space is represented as a 
double-ended cone. 

The HUE coordinate runs 
counterclockwise around the 
cone. (0 to 360 degrees. 

The LIGHTNESS coordinate runs 
vertically up the cone. (0% to 100% 

The SATURATION coordinate runs 
radially outward from the axis of 
the cone. The SATURATION coordinate 
is a percentage of the maximum 
possible saturation at a particular 
LIGHTNESS level. (0% to 100%.) 



NOTE: For clarity, this figure 
shows the cone divided into only 
64 colors, as in the TEKTRONIX 
4027 terminal. The 41 13 termi- 
nal has a wider repertory of color 
mixtures; for the 41 1 3, the HLS 
cone is divided into 4096 dis- 
tinct cells. 



Figure E-1 . The HLS Color Cone. 
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100% -r 



HUE I Yellow 180 

200° 



0%-"- 



HI 

z 
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TEKTRONIX 

COLOR 

STANDARD 



Overview: 

The world of color is filled with ambiguous 
terminology, i.e. intensity, purity, value, etc. 
Many color users feel that "color theory" is a 
prerequisite to operating color systems; T.V., 
Videotaping, Photography, Computer Graph- 
ics. 

In order to end this confusion, Tektronix has 
developed a color language and function 
based on human engineering, rather than 
machine engineering. Below is a description 
of this system, which will provide a clear 
and concise means for understanding how 
color is defined and how our syntax was 
derived. 

Color Concepts: 

Color selection is specified by hue, light- 
ness and saturation which is the HLS 
method. The definitions are as follows: 



Saturation: The characteristic which 
describes the extent to 
which a color differs from 
a gray of the same light- 
ness. Saturation is ex- 
pressed as percentage, 
ranging from 0% (maxi- 
mum white content at that 
lightness level) to 100% 
(full saturated). 

Geometrically, colors can be described in 
terms of a double cone. 
Variations in lightness are represented 
along the axis, with white at the apex of 
the cone and black at the opposite apex. 
Variations in saturation are represented by 
radial distances from the lightness axis, in 
constant lightness planes. Hue is repre- 
sented as an angular quantity from a known 
reference point. 



Hue: 



The characteristic associ- 
ated with a color name 
such as red, yellow, green, 
blue, etc. Hue is a grada- 
tion of color advanced by 
degrees, thus represented 
as an angle from to 360. 



Lightness: 



The characteristic that al- 
lows the color to be 
ranked on a scale from 
dark to light. Lightness is 
expressed as a parameter 
ranging from to 1 00% 
with black being (bot- 
tom of cone) and white 
being 100% (top of cone). 
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This index is a "Keyword in Context" index . A Keyword in 
Context index contains an entry for each significant word in 
the command name. For example , the <Includ e-Copy-of~Segment> 
command can be found under C, I , and S as follows: 

Include Copy of Segment 

Include Copy of Segment 
Include Copy of Segment 



Since many 4110 Series command names begin with "Set/ 1 the 
word "set" is not included as a keyword for indexing 
pur po ses . 



Set Page Full 
Enter 
Set 
Set 
Set 4014 

Set Pick 

Enable Dialog 
Set Dialog 
Set Dialog 
Set Dialog 
Set Dialog 
Set Dialog 
Set Dialog 
Set Dialog 
Set Dialog 
Set Graphics 



Int 
Int+ 

Char 

Int 
Char 
Port 
Set View 



Action 4-445 

Alpha Mode . . . 4-127 

Alphatex t Font ....... . 4-309 

Alphatex t Si ze 4-3 1 

Alphatex t Si ze 4-570 

ALU Mode . 4-24 

Aperture 4-457 

A.r e a • ••••••••©•..••.••.••••4 — 99 

Area Buffer Size 4-362 

Area Chars 4-364 

Area Index 4-366 

Ar e a Lines •••••••••••••••••4—370 

Area Po sit ion . . . 4-372 

Area Sur face 4-374 

Area Visibility 4-376 

Area Wr iting Mode 4-379 

Area Wr iting Mode 4-4 1 9 

Arm For Block Mode 4-2 

Array 4-5 

Array 4-5 

Array ...................... 4-5 

Array 4-5 

Array Report ............... 4-7 

Array Report ............... 4-7 

Array Report 4-7 

Assign .4-228 

Attributes 4-556 
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B 

Set Background Color 4-314 

Set Background Gray Level 4-3 1 6 

Set Background Indices 4-3 1 8 

Set Baud Rates 4-321 

Set Port Baud Rate .4-467 

BAUDRATE 4-321 

Set Pixel Beam Position 4-463 

Begin Fill Pattern 4-9 

Begin Gr aphtex t Character .,4-14 

Begin Panel Boundary 4-14 

Begin Pixel Operations 4-23 

Begin Segment 4-29 

BEL Character 4-33 

BHEADERS ............ .4-329 

Set Port Stop Bits . . 4-480 

Set Stop Bits 4-524 

BLENGTH .4-332 

BLINELENGTH 4-334 

Arm For Block Mode 4-2 

Bl O C k .se9aeaeeeaea««eee«e»o4 — 34 

Block Header . .4-34 

Block Continue Char 4-34 

Block End Char 4-34 

Block Control Eytes 4-36 

Set Block Continue Chars 4-325 

Set Block End Chars 4-327 

Set Block Headers 4-329 

Set Block Length ..4-332 

Set Block Line Length 4-334 

Set Block Master Chars 4-336 

Set Block Non Xmt Chars 4-338 

Set Block Packing 4-341 

Set Block Timeout 4-348 

BLOC KM ODE 4-2 

BMASTERCHARS 4-336 

BNONXM TCHARS ..4-338 

BORDER Key 4-43 

Set Border Visibility 4-350 

Begin Panel Boundary 4-1 4 

BPACKING 4-341 

BREAK Key 4-44 

Set Break Time 4-352 

BREAKTIME 4-352 
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BS Character 4-45 

BTIMEOUT 4-348 

Set Dialog Area Buffer Size 4-362 

Bypass Cancel Char 4-47 

Enter Bypass Mode 4-129 

Set Bypass Cancel Char 4-354 

BYPASSCANCEL 4-354 

Block Control Bytes 4-36 

C 

Bypass Cancel Char 4-47 

Cancel Command 4-48 

Set Bypass Cancel Char 4-354 

CANCEL Key 4-50 

Char Array 4-5 

Char Array Report 4-7 

Block Continue Char 4-34 

Block End Char ......4-34 

Bypass Cancel Char 4-47 

Char 4-51 

Char Report 4-52 

EOM Char 4-136 

Set Bypass Cancel Char 4-354 

Begin Graphtext Character 4-14 

BEL Character 4-33 

BS Character 4-45 

CR Character 4-62 

DEL or RUB OUT Character 4-69 

Delete Graphtext Character 4-73 

End Graphtext Character 4-123 

US Character 4-127 

FS Character 4-132 

GS Character 4-133 

ESC Character 4-142 

HT Character 4-174 

Key Ex ecute Character 4-191 

LF Character 4-1 92 

Set Key Execute Character 4-432 

Set Tablet Header Characters 4-455 

Set Block Continue Chars 4-325 

Set Block End Chars 4-327 

Set Block Master Chars 4-336 

Set Block Non Xmt Chars 4-338 

Set Dialog Area Chars 4-364 
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Set Edit 
Set EOM 

Set Report Sig 
Set Current Matching 
Set Segment 



Set View Display 



Dev ice-Function 
Set Background 
Set 

Set Surface 
Block 
Set Block 
Block 
HARD 



Include 
Pixel 

Port 



Set 
Set GIN 



Chars . 
Chars . 
Chars . 
Class . 
Class . 
CLEAR Key 
Clear Dialog Scroll 
Cluster 
CMAP . . 



CMODE . 
Code . . 
Color . 
Color Mode 
Color Map « 
Continue Char . 
Continue Chars 
Control Bytes . 

COPY Key 

C Plf* 
Copy 

Copy of Segment 
Copy .......... 

Co p y •••••••••• 

CR Character . . 
CRLF Command . . 
Current Matching Class 
Cu r so r 



.4-385 
.4-393 
.4-495 
.4-360 
.4-498 
.4-54 
.4-55 
. .4-559 
. .4-525 
. .4-356 
. .4-103 
. .4-314 
.4-356 
•525 
-34 
-325 



4- 
4- 
4- 



. .4-36 
. .4-172 
. .4-56 
. .4-56 
. .4-177 
. .4-218 
. .4-233 
. .4-62 

. .4-63 
. .4-360 
. . 4-405 



D 



DABUFFER . . . 

DA CHARS 

DA INDEX 

DALINES 

DAMODE 

DAPOSITION . 
DASURFACE . . 

DAVIS 

Packed Data 

Pixel Def 

Define Macro 
Fill Pattern Definition . 

Panel Definition . 
Segment Definition . 
Fill Pattern Definition . 

Panel Definition . 



. 4-362 

4-364 

4-366 

4-370 

4-379 

• • • • • ^4 **■■ 3 V 2 

. 4-374 

4-376 

.4-34 

4-221 

4-64 

U-Q 

• • • a • ^4 2 

o • • • o ^4 1 ^45 

4-215 
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OcU OU I Idle 


4^* 4 Y\ 4 4" 4 W"k «3 
J/© I llllU lOO 5 • 9 • e • • o , • • . o . • , 


1 1 (TOQ 




ujL u or nuD u u i inarac ter • , 




O t; U 11 du bill JL U 




li ceo 
• ^'-O De- 




net pTr 


ll 7 1 




Lie i ete nq ui v oi en u 






De X e t e File .••••••««•••••< 






Dei ete urapntext inarac ter 


• 4-73 




Delete Segment 


. 4-75 




il a T 4* \ T A >~v 1 t 




ignore 


li "1 A™ s?> 


il 1 7K 


ucL o e g r n e n u 


4" ^ 4" "i i ^ 4> t r 


li cm 




i/e v ic e o l a u us nepor t 




ul 1M 


Tj| £\ 1/ 1 /*| A 


li 1 no 


nc pu i u 


UcVlCc oiaius • 


ji o A H 






li — 1 n q 




HT A T OH K'a v 


li &c 


Ul cdf 


Ftl *i «*a 1 rr Q ^ k» /^v. 1 1 


li c c 


Rn ah 1 p 


Fli al no At« o q 


ll _ Q Q 




Hi al hvaoi Ruf for Qi 7a 


ll Q 


Qp 4- 


Fl"f !D 1 A V Cl PVl »ir O 


li q All 


Ca f 


uiaiog rv ea in a ex 


• 4- J DO 


q f 
oc u 


11 «• ^-k J tf«lp A Vft y-\ ,r*»4 T 1 V% if*fl 


il 07H 




i/i ai og fir e a ro siLion 


il 70 




Jul aiog Area our lace 


ll 0*7)1 

• 4-374 




uiaiog Area visiDiiity « . . . 






Dialog Area Writing Mode . . 


. 4-379 




i% T *» fiA j" f\ y* \f 

*J JL 1 vv wv I V ••••••••••••••••« 


. <4-00 




Disable GIN 


.4-92 




Disable 4953 Tablet GIN 


. 4-94 


Set Segment 


Display Priority 


.4-503 


Set View 


Display Cluster 


.4-559 










Fit" 9 Ma^l/fiyi 

1/1 dW rial Kef 


il 7 




niipi JTY 

aJ> \J & JLj Jh, eeeeeaeeesseeeeoaeee 


il Q 1 


Oct 


uu pi ex node . . . . 


. 4™3 o l 






il Q O 


Set 


Echo e . . , 


.4-383 


Set 


Edit Chars 


,4-385 




EI3ITCHA.KS o«e«eoe«eeaee«»iBa« 


.4-385 






.4-99 




E)^ d b 1 e GIN •o«««««e««a««e«< 


.4-103 




Enable 4010 GIN 


.4-111 




Enable 4953 Tablet GIN 


.4-115 
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Block End Char 4-34 

End Fill Pattern 4-122 

End Gr aphtex t Character ....4-123 

End Panel 4-124 

End Segment 4-126 

Set Block End Chars 4-327 

Enter Alpha Mode 4-127 

Enter Bypass Mode 4-129 

Enter Marker Mode 4-132 

Enter Vector Mode ...4-133 

EOF String 4-1 34 

Set EOF String 4-388 

Set Port EOF String ....4-469 

EOF STRING 4-388 

EOL String 4-1 35 

Set Port EOL String 4-471 

Set EOL String . . 4-391 

EOLSTRING 4-391 

EOM Char 4-136 

EOM Indicator 4-138 

Set EOM Chars . 4-393 

Set Report EOM Fequency 4-489 

EOMCHARS 4-393 

Delete Equivalent 4-70 

Error Report 4-140 

Set Error Threshold 4-397 

ERRORLEVEL 4-397 

Report Errors 4-266 

ESC Character 4-1 42 

Key Execute Character 4-191 

Set Key Execute Character 4-432 

Expand Macro 4-1 43 

F 

Delete File 4-71 

Protect File 4-241 

Rename File 4-257 

Begin Fill Pattern 4-9 

Fill Pattern Definition 4-9 

End Fill Pattern 4-122 

Fill Pattern Definition 4-1 45 

Rectangle Fill 4-255 

Select Fill Pattern 4-301 

Set Panel Filling Mode 4-447 

Set GIN Stroke Filtering 4-416 

FIXUP 4-399 
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Set Fixup Level 4-399 

FLAGGING 4-402 

Set Flagging Mode 4-402 

Set Port Flagging Mode 4-473 

Set Alphatext Font 4-309 

Set Graphtext Font 4-421 

Set Graphtext Font Grid 4-424 

FORMAT .4-146 

Format Volume .4-146 

Set Report EOM Frequency 4-489 

FS Character 4-1 32 

Set Page Full Action 4-445 

Device- Function Code 4-103 

GIN Function 4-1 03 

G 

GAMODE 4-419 

Disable GIN 4-92 

Disable 4953 Tablet GIN 4-94 

Enable GIN 4-103 

GIN Device 4-1 03 

GIN Function 4-103 

Enable 4010 GIN 4-111 

Enable 4953 Tablet GIN 4-115 

GIN Locator Report 4-150 

GIN Pick Report 4-152 

GIN Report Sequence 4-154 

GIN Stroke Report ....4-160 

Report GIN Point 4-268 

Set GIN Cursor 4-405 

Set GIN Gridding 4-409 

Set GIN Inking 4-412 

Set GIN Rubberbanding 4-414 

Set GIN Stroke Filtering 4-416 

4010 GIN Report 4-610 

4953 Tablet GIN Report 4-618 

Graphic Input See GIN 

Graphic Text 4-165 

Set Graphics Area Writing Mode .4-419 

Begin Graphtext Character 4-14 

Delete Graphtext Character 4-73 

End Graphtext Character 4-123 

Graphtext 4-1 65 

Set Graphtext Font 4-421 

Set Graphtext Font Grid 4-424 

Set Graphtext Precision 4-427 
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Set Graphtext Rotation 4-429 

Set Graphtext Si ze 4-431 

Set Background Gray Level 4-316 

Set Surface Gray Levels . . 4-534 

Set Graphtext Font Grid 4-424 

GRIDDING . . . 4-409 

Set GIN Gridding 4-409 

GS Character 4-133 

H 

HARD COPY Key 4-172 

Hardcopy 4-170 

4010 Hardcopy 4-612 

Block Header 4-34 

Set Tablet Header Characters .4-545 

Set Block Headers 4-329 

Hi I Bytes 4-179 

Hil-Report 4-186 

Set Segment Highlighting ..4-505 

HT Character ...4-174 

I 

Set Pick ID 4-459 

Ignore Deletes ..4-175 

Set Segment Image Transform 4-508 

Include Copy of Segment ....4-177 

Map Index to Pen 4-202 

Set Dialog Area Index 4-366 

SG t Li 1 ri 6 I n Cl 6X se.ooooo.eooeeaeee.e.. 4 — 4 3 4 

Set Text Index 4-550 

EOM Indicator 4-138 

Set Background Indices . . . 4-3 1 8 

Set GIN Inking 4-412 

Int Array 4-5 

In t Array Report 4-7 

Int and In t+ Parameters . ... 4-1 79 

Int+ Array 4-5 

Int and Int+ Parameters ... 4-1 79 

Int-Report 4-186 

K 

BORDER Key 4-43 

BREAK Key .4-44 
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CANCEL Key 4-50 

CLEAR Key 4-54 

DIALOG Key 4-85 

HARD COPY Key 4-172 

Key Ex ecute Character 4-191 

LOCAL Key 4-197 

NEXT VIEW Key 4-207 

NORMAL Key 4-208 

OVERVIEW Key 4-209 

PAGE Key 4-213 

PAN Key 4-214 

RESTORE Key 4-283 

Set Key Execute Character 4-432 

SETUP Key 4-573 

VIEW Key 4-596 

ZOOM Key 4-607 

Lock Keyboard 4-1 98 

Lock Viewing Keys 4-200 

L 

Set Block Length 4-332 

Set Block Line Length 4-334 

Set Report Max Line Length 4-491 

ERROR LEVEL 4-397 

Set Background Gray Level 4-3 1 6 

Set Fixup Level 4-399 

Set Surface Gray Levels 4-534 

LF Character 4-192 

LFCR Command 4-193 

Set Transmit Rate Limit 4-554 

Set Block Line Length 4-334 

Set Line Index 4-434 

Set Line Style 4-436 

Set Line Width 4-439 

Set Report Max Line Length 4-491 

Set 4014 Line Style 4-571 

Set Dialog Area Lines 4-370 

Lol Bytes 4-179 

Lol-Report 4-1 86 

LOAD 4-195 

Load 4-195 

LOCAL Key 4-197 

GIN Locator Report 4-150 

Lock Keyboard 4-198 

Lock Viewing Keys 4-200 
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M 

Define Macro 4-64 

Expand Macro .4-143 

Map Index to Pen 4-202 

Set Surface Color Map 4-525 

MARGIN 4-440 

Set Margins 4-440 

Draw Marker 4-97 

Enter Marker Mode ....4-132 

Set Marker Type 4-443 

Set Block Master Chars 4-336 

Set Current Matching Class 4-360 

Set Report Max Line Length 4-491 

Arm For Block Mode 4-2 

ALU NO d 6 • •••••oe*a«c»*<ia«»aaa a» ^4 2 ^ 

Enter Alpha Mode 4-127 

Enter Bypass Mode 4-129 

Enter Marker Mode 4-132 

Enter Vector Mode 4-133 

Prompt Mode 4-239 

Set Color Mode 4-356 

Set Dialog Area Writing Mode 4-379 

Set Duplex Mode 4-381 

Set Flagging Mode 4-402 

Gr aphic s Area Wr iting Mode 4-4 1 9 

Set Panel Filling Mode . . 4-447 

Set Port Fl agging Mode 4-473 

Set Segment Wr iting Mode 4-51 8 

Set Snoopy Mode 4-522 

Move 4-205 

N 

ME XT VIEW Key 4-207 

Set Block Non Xmt Chars 4-338 

NORMAL Key 4-208 



Begin Pixel Operations 4-23 

OVERVIEW Key 4-209 
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p 

Packed Data 4-34 

Set Block Packing 4-341 

PAGE Key 4-213 

Page Command 4-211 

Set Page Full Action 4-445 

PAN Key 4-214 

Begin Panel Boundary 4-14 

Panel Definition 4-20 

End Panel 4-124 

Panel De f inition 4-2 1 5 

Set Panel Filling Mode 4-447 

PARITY 4-455 

Set Parity 4-455 

Set Port Parity .4-476 

Begin Fill Pattern 4-9 

Fill Pattern Definition 4-9 

End Fill Pattern . . 4-122 

Fill Pattern Definition 4-145 

Select Fill Pattern 4-301 

PBAUD 4-467 

PBITS 4-480 

PCOPY 4-233 

Map Index to Pen 4-202 

PEOF 4-469 

PEOL . 4-471 

PF LAG 4-473 

GIN Pick Report 4-1 52 

Set Pick Aperture 4-457 

Set Pick ID 4-459 

Set Pivot Point 4-461 

Pixel Def . 4-9 

Begin Pixel Operations 4-23 

Pixel Copy 4-218 

Pixel Def 4-221 

Set Pixel Beam Position 4-463 

Set Pixel Viewport 4-465 

PLOT 4-222 

Plot 4-222 

PMAP 4-202 

Report GIN Point 4-268 

Set Pivot Point 4-461 
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Port Assign 4-228 

Port Copy 4-233 

Port Status Report ...4-236 

Report Port Status ....4-271 

Set Port Baud Rate 4-467 

Set Port EOF String 4-469 

Set Port EOL String 4-471 

Set Port Flagging Mode ...4-473 

Set Port Parity 4-476 

Set Port Stop Bits 4-480 

Set Dialog Area Position 4-372 

Set Pixel Beam Position 4-463 

Set Segment Position 4-512 

PPARITY 4-476 

Set Graphtext Precision 4-427 

Set Surface Priorities 4-540 

Set Segment Display Priority 4-503 

Prompt Mode 4-239 

Set Prompt String 4-483 

PROM PTM ODE 4-239 

PROMPTSTRING 4-483 

PROTECT 4-241 

Protect File 4-241 

Q 

Set Queue Si ze . . 4-4 85 

QUEUESIZE 4-485 

R 

Raster Write 4-244 

Set Port Baud Rate 4-467 

Set Transmit Rate Limit 4-554 

Set Baud Rates 4-321 

Real 4-252 

Real Report 4-254 

Rectangle Fill 4-255 

RENAME 4-257 

Rename File 4-257 

Rename Segment 4-260 

RENEW 4-262 

Renew View 4-262 

REOM 4-489 
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Array Report 4-7 

Int Array Report 4-7 

Char Array Report 4-7 

String Report 4-7 

Char Report 4-52 

Device Status Report 4-79 

Error Report 4-140 

GIN Locator Report 4-150 

GIN Pick Report 4-152 

GIN Report Sequence 4-1 54 

GIN Stroke Report 4-160 

Int- Report 4-186 

Hil- Report 4-1 86 

Lol- Report 4-1 86 

Port Status Report 4-236 

Real Report 4-254 

Report Dev ice Status 4-264 

Report Errors 4-266 

Report GIN Point 4-268 

Report Port Status 4-271 

Report Segment Status 4-273 

Report Terminal Settings . . . 4-277 

Report 401 Status 4-281 

Segment Status Report 4-295 

Set Report EOM Frequency 4-489 

Set Report Max Line Length 4-491 

Set Report Sig Chars 4-495 

String Report 4-581 

Terminal Settings Report 4-582 

XY- Report . 4-604 

4010 GIN Report 4-610 

401 Status Report 4-614 

4953 Tablet GIN Report 4-618 

RESTORE Key 4-283 

RLINELENGTH 4-491 

Set Graphtext Rotation 4-429 

DEL or RUB OUT Character 4-69 

Set GIN Rubberbanding 4-414 

Runcode 4-285 

Runlength Write 4-285 

S 

SAVE 4-288 

Save 4-288 

Clear Dialog Scroll 4-55 



41 10 SERIES COMMAND REFERENCE 1-13 



Begin Segment . . . . 4-29 

Segment Definition 4-3 1 

Delete Segment ......... 4-75 

End Segment 4-126 

Include Copy of Segment 4-177 

Rename Segment 4-260 

Report Segment Status 4-273 

Segment Status Report 4-295 

Segment Matching Class 4-360 

Set Segment Class .............. 4-498 

Set Segment Detectability 4-501 

Set Segment Display Priority . . . 4-503 

Set Segment Highl ighting 4-505 

Set Segment Image Transform .... 4-508 

Set Segment Position 4-512 

Set Segment Visibility . . . . 4-51 5 

Set Segment Writing Mode 4-51 8 

Select Fill Pattern 4-301 

Select View 4-306 

GIN Report Sequence 4-1 54 

Report Terminal Settings 4-277 

Terminal Settings Report 4-582 

SETUP Key . .4-573 

Set Report Sig Chars 4-495 

Set Alphatex t Size . . 4-310 

Set Dialog Area Buffer Size 4-362 

Set Gr aphtext Size 4-431 

Set Queue Si ze 4-485 

Set 4014 Alphatext Size 4-570 

SNOOPY . .4-522 

Set Snoopy Mode 4-522 

SPOOL . . . . 4-574 

Spool . . 4-574 

Stop Spooling 4-579 

STATUS 4-578 

Device Status Report . . 4-79 

Port Status Report 4-236 

Report Device Status 4-264 

Report Port Status . . . 4-271 

Report Segment Status . . 4-273 

Report 401 Status ..................... 40281 

Segment Status Report 4-295 

Set Tablet Status Strap 4-548 

4010 Status Report 4-614 

STOP 4-579 

Set Port Stop Bits 4-480 



1-14 



4110 SERIES COMMAND REFERENCE 



Set Stop Bits 4-524 

Stop Spooling ..4-579 

STOPBITS 4-524 

Set Tablet Status Strap . . 4-548 

String ...4-5 

String Report 4-7 

EOF String . 4-134 

EOL String 4-1 35 

Set EOF String 4-388 

Set EOL String ...4-391 

Set Port EOF String 4-469 

Set Port EOL String 4-471 

Set Prompt String . 4-483 

String .. ... 4-580 

String Report 4-581 

GIN Stroke Report 4-160 

Set GIN Stroke Filtering . ,., 4-416 

Set Line Style .. . 4-436 

Set 4014 Line Style ... .. . ... 4-571 

Set Dialog Area Surface 4-374 

Set Surface Color Map 4-525 

Set Surface Definitions 4-529 

Set Surface Gray Levels 4-534 

Set Surface Priorities 4-540 

Set Surface Visibility 4-543 

T 

Tab Character See HT 

Disable 4953 Tablet GIN ..... 4-94 

Enable 4 953 Tablet GIN ........4-115 

Set Tablet Header Characters ...4-545 

Set Tablet Status Strap 4-548 

4953 Tablet GIN Report 4-618 

TBHEADERCHARS 4-455 

TBSTATUS .4-548 

Report Terminal Settings 4-277 

Terminal Settings Report ...4-582 

Graphic Text 4-165 

Set Text Index 4-550 

Set Error Threshold 4-397 

Set Break Time 4-352 

Set Block Timeout 4-348 

Set Segment Image Transform 4-508 

Set Transmit Delay 4-552 

Set Transmit Rate Limit 4-554 

Set Marker Type 4-443 
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u 

US Character 4-127 

V 

Enter Vector Mode 4-133 

NEXT VIEW Key 4-207 

VIEW Key 4-596 

Delete View 4-77 

Renew View 4-262 

Select View 4-306 

Set View Attributes 4-556 

Set View Display Cluster 4-559 

Lock Viewing Keys 4-200 

Set Pixel Viewport 4-465 

Set Viewport . 4-563 

Set Border Visibility 4-350 

Set Dialog Area Visibility 4-376 

Set Segment Vi sibil ity 4-5 1 5 

Set Surface Visibility 4-543 

Format Volume 4-146 

VT Character 4-598 

W 

Sg t L i n © Wx cith •«•)>•<)<••• • ^™^39 

Set Window 4-566 

Raster Write 4-244 

Runlength Write 4-285 

Set Dialog Area Writing Mode 4-379 

Set Gr aphic s Area Writing Mode 4-4 1 9 

Set Segment Writing Mode 4-518 

X 

Set Block Non Xmt Chars ....4-338 

XMTDE LAY 4-552 

XMTLIMIT .4-554 

XY R © po r* t • « « « » • 4-604 

XY 4-599 

Z 

ZOOM Key 4-607 
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Enable 4010 GIN 4-111 

Report 4010 Status 4-281 

4010 GIN Report 4-610 

4010 Hardcopy 4-612 

4010 Status Report 4-614 

Set 4014 Alphatext Size 4-570 

Set 4014 Line Style 4-571 

Disable 4953 Tablet GIN 4-94 

Enable 4953 Tablet GIN 4-115 

4953 Tablet GIN Report 4-618 



4110 SERIES COMMAND REFERENCE 1-17 



( 



( 



( 



MANUAL REVISION STATUS 



PRODUCT: 4112/4114 Computer Display Terminals 

This manual supports the following versions of this product: Serial Numbers B01 01 00 and up. 



REV DATE 



DESCRIPTION 



MAY 1981 
JUN 1981 
JUL 1981 
JUL 1981 
DEC 1981 
MAR 1982 



Original Issue 
Revised: Appendix A. 

Manual Part No. changed to 061-2566-01 to reflect extensive revision to Section 4. 
Revised: pages 3-5, B-1 through B-7, C-6, C-7, C-8, C-19, C-20, C-32, C-34, C-37, and C-41. 
Manual Part No. changed to 061-2566-02 to reflect extensive revision. 
Revised: pages 4-545, 4-546, 4-620, D-9, D-1 2. 



41 10 COMMAND REFERENCE 



REV, MAR 1 982 
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"^^I19 T 0M @ MANUAL CHANGE INFORMATION 



product 4110 SERIES COMMAND REFERENCE change reference C4/1281, 

061-2566-02 12-1-81 

MANUAL PART NO. DATE 



EFFECTIVE ALL SERIAL NUMBERS 

TEXT CHANGES 

The pages listed below were inadvertently omitted from the March 1982 
reprinting of this manual. Please replace like numbered pages in this 
manual with the attached pages. 

Pages 4-21, 4-22, 4-109, 4-110, 4-193, 4-194, 4-215, 4-216, 4-219, 4-220, 
4-287, 4-288,4-357, 4-358, 4-459, 4-460, 4-531, 4-532, 4-533, 4-534, 
4-541, 4-542, 4-559, 4-560, 4-585, 4-586, 4-587, 4-588, 4-589, 4-590, 
4-591, and 4-592. 
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"fektronix 



® 



MANUAL CHANGE INFORMATION 



COMMITTED TO EXCELLENCE 



PRODUCT 



4110 SERIES COMMAND REFERENCE 



CHANGE REFERENCE 



C5/382 



MANUAL PART NO. 



061-2566-02 



DATE 



3-9-82 



EFFECTIVE ALL SERIAL NUMBERS 

TEXT ADDITION 

Pages 4-544-a and 4-544-b 

ADD THE ABOVE NEW PAGES TO YOUR MANUAL. CHANGE YOUR TABLE OF CONTENTS 
ACCORDINGLY. 
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Ttektronix 



MANUAL CHANGE INFORMATION 



COMMITTED TO EXCELLENCE 



PRODUCT 



4110 SERIES COMMAND REFERENCE MANUAL 



CHANGE REFERENCE 



C6/1182 



MANUAL PART NO. 



061-2566-02 



DATE 



TEXT CHANGES 



With this insert the manual part number changes from 061-2566-02 to 
061-2566-03. 

Title page, copyright page, 1-1, 1-2, 1-3, 4-1, 4-2, 4-47. thru 4-50, 4-55 
thru 4-62, 4-65 thru 4-68, 4-79 thru 4-84, 4-169 thru 4-174, 4-259 thru 4-266, 
4-305, 4-306, 4-313 thru 4-320, 4-355 thru 4-360, 4-433 thru 
4-446, 4-525 thru 4-528, 4-559 thru 4-562, 4-569, 4-570, 4-573 thru 4-578, 
4-601, 4-602, 4-613 thru 4-618, C-ll, C-12, C-15 thru C-18, C-23 thru C-26, 
C-45 thru C-54, C-57, and C-58. 

REMOVE THE ABOVE PAGES FROM YOUR MANUAL . 

ADD THE PACKET OF ATTACHED PAGES TO YOUR MANUAL. This includes new pages: 

4-2A, 4-2B, 4-16A, 4-16B, 4-16C, 4-16D, 4-16E, 4-16F, 4-56A, 4-56B, 4-68A, 
4-68B, 4-174A, 4-264A, 4-264B, 4-300A, 4-300B, 4-306A, 4-306B, 4-356A, 4-356B, 
4-434A, 4-434B, 4-434C, 4-434D, 4-444A, 4-444B, C12A, C12B, C40A, C40B, and 
C50A. 



THIS IS A PAGE REPLACEMENT PACKAGE. 



1 . Remove the appropriate pages from your manual and insert the attached pages. 

2. Update Manual Revision Status page i in the front of your manual to indicate the new 
revision letter, date revised, and which pages were revised. You will find this 
information, centered, at the bottom of each replacement page. (This update is for 
your information only.) 



3. Keep this cover sheet in the Change Information section at the very back of your 
manual for a permanent record. 
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